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Summary of Amendments 
for SH24-5005-1 
RSCS Networking Release 2 


This edition documents support included in RSCS Networking, Release 2. The 


support includes the following: 


In 


A new networking line driver, DMTRPT, extends the VM/370 spooling 
capabilities to support the IBM 3270 Information Display System printers. 
These are the IBM 3284, 3286, 3287, 3288, 3289, and the IBM 3262, Models 3 
and 13 Printers (when appropriately attached to the IBM 3271, 3272, 3274, 
and 3276 control units). Features supported include Data Analysis—APL, 
APL/Text, and Vertical Forms Control. 


Use of the IBM 3380 DASD as an RSCS system disk. 

Allowing FORM and 3800 printer spool file attributes, and LOAD FCB, FOLD, 
and UNFOLD CCWs for 3211 print files to be transmitted between a VM/370 
node and either another VM/370 node or a non-VM/370 NJI/ZNJE node, and to 


allow querying and modifying the spool file attributes. 


A new keyword has been added to the workstation SIGNON card for the DMTNPT 
line driver to allow suppressing the header page. 


The maximum buffer size for the DMTNJI line driver has been increased to 
3976 bytes. 


addition, in this publication: 
A new installation procedure is described, and 


A neW appendix has been added that describes user exits in RSCS Networking. 
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Preface 


This publication is for the VM/370 system programmer installing the Remote 
Spooling Communications Subsystem Networking program product (called RSCS in 
this manual), the RSCS operator, and the VM/370 virtual machine user using 
RSCS. It describes: 

¢ The characteristics and components of RSCS 

e How to install RSCS 


e How to operate RSCS 


° How a VM/270 virtual machine user uses RSCS. 


Note: 
In this manual the term "RSCS" refers to the 
Remote Spooling Communications Subsystem Networking 


program product. It does not refer to the Remote 
Spooling Communications Subsystem component of 
VM/370. Where these two different programs are 
discussed together, the difference 15 made clear. 


The publication contains five major parts. 
Part 1: Introduction contains three sections: 


"RSCS Overviewn"™ describes the requirements of RSCS and operation of a 
VM/370 virtual machine using RSCS as the operating system. 


"Components of RSCS" describes the functions and relationships of the major 
components of RSCS. 


"Job Output Routing Overview" summarizes the job output routing 
Capabilities of RSCS and the spooling interface programs with which RSCS$ 
can communicate. 


Part 2: RSCS Installation contains two sections: 


"Planning to Install RSCS" describes how to create the RSCS directory and 
gives guidelines for selecting line drivers. 


"Installing RSCS" describes the RSCS data and control files on the 


distribution tape and illustrates the steps for actually installing RSCS on 
a VM/370 system. 
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Part 3: RSCS Operation contains two sections: 


"Operation Description” discusses general operation, the operator commands, 
and the operator messages. 


"Operation Procedures” describes how to start, stop, change, and control 
RSCS. 


Part 4: VM/370 User Guide explains the commands and messages available to the 
VM/370 user who uses RSCS. 


Part 5: Appendixes contains eight appendixes: 


"Appendix A: RSCS Commands” describes in detail the commands available to 
the RSCS operator. The subset of those commands available to the remote 
station operator is also identified. 


"Appendix B: RSCS Messages” describes all the RSCS messages and lists all 
the RSCS messages and responses tabulated by the command or function that 
initiated the message. A key to the distribution of each message or 
response 1s also included. 


"Appendix C: RSCS Networking User Exits” describes several routines, which 
are specifically designed for user exits, and their use. 


"Appendix D: Nonprogrammable Remote Terminals” contains a section on each 
nonprogrammable remote terminal supported by RSCS. Each section covers the 
configuration of the terminal, establishing the line connection, terminal 
operation, and error recovery procedures. 


"Appendix E: Programmable (Spool MULTI-LEAVING) Remote Stations” contains a 
section on each programmable remote station supported by RSCS acting as a 
host, and a section on RSCS acting as a job entry station to a remote 
HASP/ASP batch system or its equivalent. Each section covers the supported 
configuration of the station, establishing the line connection, station 
operation, and error recovery procedures. 


"Appendix F: VSE/POWER Remote System Connection” is an example of 
connecting a basic VSE/POWER system to RSCS Networking. 


"Appendix G: Base Tape Contents™ contains a list of the contents of the 
base tape. 


"Appendix H: Abbreviations” defines the abbreviations used in this 
publication. 
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Part 1 introduces RSCS by 
presenting: 


e Overview of RSCS 
e Components of RSCS 


e Overview of Job Output Routing 


Part 1: 


Part 1: Introduction 
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RSCS Overview 


RSCS provides Remote Job Entry into a VM/370 system and allows a VM/370 system 
to participate in a network of computer systems that support the Network Job 
Interface/Network Job Entry (NJI/NJE) protocol. 

RSCS is the successor to both the RSCS component of VM/370 and the VM/370 
Networking (VNET) PRPQ (Program Number 5799-ATA). It is a functional superset 
of both of these earlier programs. 

RSCS is a complete virtual machine subsystem that operates independently of 
other virtual machines running under the VM/370 Control Program. Together 
With the Control Program, RSCS controls communication input/output devices and 
lines used to transfer files between: 

e VM/370 users on different VM/370 systems 

e VM/370 users and remote NJI/NJE type batch systems 

e VM/370 users and remote VSE/POWER batch systems 

e VM/370 users and remote stations 

¢ Remote stations and other remote stations 

e Remote stations and NJI/NJE type batch systems 

e Remote stations and a CMS batch virtual machine 

e One NJI/NJE system and another NJI/NJE system 

RSCS employs the same system interfaces with which VM/370 users are familiar. 


RSCS does not take away any existing capabilities of VM/370, the RSCS 
component of VM/370, or VNET. 


REQUIREMENTS OF RSCS 


RSCS’s requirements for programming systems, storage, and hardware products 
are as follows: 


PROGRAMMING SYSTEMS 


RSCS is supported on VM/370 Release 6 and the releases of VM/370 Basic System 
Extensions, VM/370 System Extensions, and VM/System Product (VM/SP) program 
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products supported by VM/370 Release 6. RSCS relies on the VM/370 system 
spooling facility. Fixed Block Mode DASD support and CMS Extended Disk Format 
support require VM/370 Basic System Extensions, VM/370 System Extensions, or 
VM/SP program products. The new function in RSCS Release 2, with the 
exception of locally-attached 3270 Information Display System printers, 
requires VM/SP. 


RSCS runs in a single virtual machine as a telecommunications subsystem for 
the VM/370 system. It requires a standard VM/370 virtual machine with tele- 
communications facilities attached to that virtual machine. Normal operation 
can be conducted without operator intervention and RSCS can be run 
disconnected. 


AUXILIARY STORAGE 


Adequate CMS formatted disk space must be provided to contain RSCS object 
modules and network EXEC files. Approximately 450 800-byte blocks of IBM 
CKD-type DASD space, or 650 512-byte blocks of IBM Fixed Block Mode type DASD 
space should be adequate, depending on how many network EXEC files are 
maintained by the installation. When a Fixed Block Mode device is used for 
RSCS DASD storage requirements, the VM/370 Basic System Extensions, VM/370 
System Extensions, or VM/SP program products are required. When a 3380 is 
used for RSCS DASD storage, VM/SP is required. 


VIRTUAL STORAGE 


RSCS adapts to a virtual storage size of 384K or greater. 


PROCESSORS AND REAL STORAGE 


RSCS runs on any processor that is supported by VM/370 Release 6 or VM/SP and 
is equipped with real storage of at least 384K. 


REMOTE NODES 


RSCS's main function is to communicate with remote nodes across 
telecommunication facilities in binary synchronous mode, and across 
channel-to-channel adapters. All support for the communication is within the 
RSCS virtual machine. RSCS can communicate with the remote nodes listed in 
Figure l. 
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ROLES PERFORMED BY RSCS ) 


RSCS can perform four different roles: 

e Host system for programmable terminals 

e Host system for nonprogrammable terminals 

e Peer system for NJI/NJE systems 

e Remote job entry workstation for BSC host systems 


These four roles are reflected in Figure l. 


Remote System Nodes 


RSCS is a Peer to RSCS is a Workstation to 
NJI/NJE Systems: BSC Host Systems: 


Any system capable of running: Any system capable of running: 


RSCS Program Product VSE/POWER Program Product 

VNET PRPQ of DOS/VSE 

JES2/NJE Program Product RES component of OS/VS1 

HASP Networking PRPQ Release 2 and above 

ASP Networking PRPQ JES2 component of OS/VS2 

JES3/NJE PRPQ Release 2 and above 
JES3 component of OS/VS2 
HASP II Versions 3.1 or & 
ASP Version 3.2 


Remote Station Nodes 


RSCS is a Host to RSCS is a Host to 
Programmable Terminals: Nonprogrammable Terminals: 


Any system programmed to provide 2770 Data Communication System 
the MULTI-~LEAVING line protocol: with the 2772 Multipurpose 
Control Unit 
System/360 Model 20 and above 2780 Data Transmission Terminal 
System/370 Model 115 and above Models 1 and 2 
1130 3770 Data Communication System 
System/3 Model 6 and above in 2770 BSC Mode 
2922 3780 Data Communications 
3777 as a System/360 Model 20 Terminal 
System/32 3270 Information Display System 
8100 Printers 


Figure 1. Remote Nodes with which RSCS Can Communicate 
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HOW RSCS WORKS 
Figure 2 is an overview of RSCS operations in a simple network. (Not all 


network nodes must be VM/370 RSCS nodes; this figure simply shows the types of 
operations that RSCS supports.) 


User Archie on the CMS system at VM1l sends file PLANXYZ SCRIPT to user Bob on 
the CMS system at VM3 by issuing the commands: 


SPOOL PUNCH TO RSCS1 
TAG DEVICE PUNCH VM3 BOB 
PUNCH PLANXY2 SCRIPT 


VM1 CP spools Archie’s virtual punch output to RSCS1. RSCS1 may have any 
number of links to the other network nodes, but it has locally-specified 
tables that indicate that files for VM3 are to go to VM2. RSCS1 sends the 
spool file, including its destination information, to VM2. RSCS2 on VM2 
receives the file, stores it by spooling it to its own userid, and then 
forwards it to VM3. RSCS3 at VM3 recognizes that the file is for its own 
location and spools it to userid Bob. 


| Archie | Bob 


. 
VM1 VM2 VM3 
Figure 2. RSCS File Handling Example 
RSCS AS AN OPERATING SYSTEM 
RSCS is a single-purpose operating system for a virtual machine, dedicated to: 
e Accepting files spooled to it and transmitting these files to the 
destinations specified by the files" submitters. 
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e Accepting files transmitted to it and either spooling these files to the 
appropriate local VM/370 users or transmitting these files to the 
destinations specified by the files’ submitters. 


Transmission is via binary synchronous communication lines or 
channel—to-—channel adapters. Telecommmunications facilities must be attached 
to the RSCS virtual machine either permanently or temporarily. 


Once RSCS has been initialized, the RSCS operator may disconnect his console 
and run RSCS in disconnected mode. RSCS operates normally without regular 
operator intervention. 


Internally, RSCS consists of a multitasking supervisor, system control tasks, 
and line driver tasks. The system control tasks provide common services to 
the line driver tasks and provide communication with the RSCS operator. Each 
line driver task manages the transmission of files to and from a single remote 
node and provides a communication path for remote node operator commands. 


RSCS DIRECTORY 


RSCS's primary file is its directory, Which defines the local RSCS subsystem 
and its view of the network in which it participates. The RSCS directory 15 a 
CMS file, maintained on disk, so that changes in network definition can be 
made easily by the RSCS operator or the RSCS system programmer. 


SPOOL FILE TAGS 


Each VM/370 output spool file contains an information field called the spool 
file tag. At the point of origin, the submitter (typically a VM/370 user 
operating a CMS virtual machine) specifies the file's destination location in 
the spool file tag. The submitter can also specify the file's transmission 
priority on a scale of 0 — 99, With 50 as the default. 


To transmit a file, the submitter issues a command that causes the output from 
the originating device to be given to RSCS. Then, RSCS (not the submitter) 
determines how the file is to be routed to the specified destination. The 
submitter receives a message indicating every move of a file from one node to 
another on the way to its destination. 


NETWORK NODES 


A node is a remote station or a remote system connected to RSCS, either 
directly or indirectly. For example, in Figure 2 node VM3 is directly 
connected to node VM2 and indirectly connected to node VMl; nodes VM2 and VM3 
are remote systems with respect to node VM1l. Every node in the network is 
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assigned a unique name. (The name is a one= to eight-character alphameric 
location identification, such as HOUSTON, DEPT14, BLDG76, ACCNTNG, or FLOOR.) 


COMMUNICATION LINKS 


A link is the transmission path between the local RSCS virtual machine and any 
directly connected (adjacent) node in the network. A link definition consists 
of the remote node’s name and other information about the transmission path, 
such as the type of line driver to be used ane the class(es) of files that may 
be transmitted on the link. Link definitions are maintained in each RSCS 
machine’s directory, and provide the basis for the tables that RSCS uses to 
route files. 


RSCS uses two tables in routing files: the link table, Which specifies the 
link to each adjacent node in the network, and the routing table, which 
specifies the next link that a file is to use to reach a destination node not 
adjacent to the local system. 


When presented with a file from a remote node in the network, RSCS checks the 
node name in the file’s tag to see if the file is for the local node. If the 
file is for the local node, RSCS transfers it accordingly within the local 
VM/370 system. If the file is destined for some other node, RSCS searches its 
link table Cand routing table, if necessary) to find the node name that 
matches the node name specified in the file's tag. RSCS then uses the 
associated link definition to begin transmission. 


Once transmission of a file from one system to another has been completed, the 
receiving system is responsible for the integrity and recovery of the file in 
the event of a network or system failure. This iS done via the system's spool 
file facility, thus utilizing each system’s provisions for integrity and 
recovery. 


REMOTE STATIONS 


A remote station in RSCS context iS any Workstation on the other end of the 
link with the RSCS virtual machine. RSCS supports both programmable and 
nonprogrammable workstations, as indicated in Figure 1. Nonprogrammable 
Workstations, such as the IBM 2780, are hard-wired to provide the line 
protocol for them to function as remote stations. 


Programmable workstations, such as the IBM System/3 and System/370, are 
processing systems with attached binary synchronous communications (BSC) 
adapters. These systems must be programmed to provide the MULTI-LEAVING line 
protocol necessary for their I/0 devices to act as remote stations. This 
programming support is provided by a Remote Terminal Processor (RTP) program 
generated according to HASP Workstation protocol and tailored to the system's 
hardware configuration. Some programmable workstations, like the System/3, 
can only be programmed to function aS remote terminals. Others, like the 
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System/360 and System/370, can function either as remote terminals or as host 
batch systems using RSCS as a remote job entry workstation. 


REMOTE SYSTEMS 


A remote system in RSCS context is any NJI/NJE system or BSC host system, as 
listed in Figure 1. RSCS appears as a peer to an NJI/NJE system. RSCS 
appears as a remote job entry workstation to a BSC host system. 


LINE DRIVERS 


Line drivers perform the actual data transmission functions for all 
communication links. The line drivers enable RSCS to manage different 
protocols concurrently. The seven types of line drivers and their roles are 
listed in Figure 3. 


RSCS manages communication lines concurrently for a number of remote nodes of 
the various supported types; the maximum number depends on the virtual storage 
size of the RSCS virtual machine. 


OTHER CAPABILITIES OF RSCS 


RSCS also provides store~and—-forward facilities for data files, network 
commands, and messages Without operator intervention. 


An automatic command execution facility aids an RSCS operator in issuing 
repeated sequences of RSCS commands. Other commands allow an RSCS operator to 
reconfigure the network during normal operations. Automatic logon, IPL, and 
startup facilities simplify the operation of RSCS. 


RSCS enables manual Workload leveling. An RSCS operator can change the 
destination of a job from an overloaded processor to another with open time. 


RSCS generates an accounting record for each file received or transmitted. 
These records contain information on the origin, destination, and record count 


of each file. 


An RSCS system programmer uses the Conversational Monitor System (CMS) to 
maintain RSCS. 
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Line Driver 
Designation Type of Communication 


Figure 3. 


VM/370 host to programmable remote stations 
via binary synchronous lines (using the spool 
MULTI-LEAVING communication technique) 


VM/370 workstation to RES, JES2, JES3, HASP II, 
and ASP BSC host systems via binary synchronous 


lines 


VM/370 Workstation to VSE/POWER host systems 
via binary synchronous lines 


VM/370 host to nonprogrammable terminals via 
binary synchronous lines 


Permits VM/370 to spool files to local or remote 
3270 Information Display System printers (IBM 3284, 
3286, 3287, 3288, 3289, or 3262 Models 3 and 13). 
VM/370 to VM/370 via binary synchronous lines 


VM/370 to VM/370 via channel-to—channel adapters 


VM/370 to non VM/370 NJI/NJE systems via binary 
synchronous lines or channel-to-channel adapters 


RSCS Line Drivers and their Roles 
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Components of RSCS 


RSCS consists of a multitasking supervisor, system control tasks, and line 
driver tasks. Figure 4 shows these major components. 


MSUP 
Multi-tasking 
Supervisor 


REX AXS 
Main RSCS Spool Access 


LAX 
Line Access 
Manager Task 


Control Task Manager Task 


SML P OW 
Line Line 
Driver Driver 
Task Task 


VMC 
Line 
Driver 
Task 


Figure 4. Components of RSCS 


RSCS SUPERVISOR 


The RSCS supervisor supports multiple RSCS control tasks and line driver tasks 
that may be active at any one time. This supervision involves multitask 
dispatching, management of virtual I/O devices used by RSCS, and management of 
virtual storage for each task. 


RSCS CONTROL TASKS 


The RSCS control tasks provide communication with the RSCS operator and common 
services to the line driver tasks. These services include command execution, 
message distribution, program check handling, VM/370 spool system interface, 
and communication line allocation. 
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RSCS LINE DRIVERS 


Each line driver task manages the transmission of files to and from a single 
remote node or workstation and provides a communication link for remote 
operator commands. Because of functional and hardware differences in remote 
system and terminal equipment, each line driver is written to support a 
specific class of remote node. 


SPOOL MULTI-LEAVING (SML) LINE DRIVER 


MULTI-LEAVING is the name of the communication technique used by the SML line 
driver operating under RSCS. Basically, physical records input to 
MULTI-LEAVING are reduced to a series of character strings of two basic types: 
a variable length non-identical series of characters, and a variable number of 
identical characters. The segmentation of physical records into these 
character strings takes advantage of identical character compression. 

Multiple physical records (now in the form of character strings) are grouped 
into a single transmission block. MULTI-LEAVING enables a bidirectional 
interleaved exchange of transmission blocks, each containing multiple data 
streams. For a detailed description of MULTI-LEAVING see the IBM VM/370: RSCS 


Networking Logic manual. 
The SML line driver, operating as a task under RSCS provides VM/370 with 
support of MULTI-LEAVING, binary synchronous communications (BSC) line 


protocol for programmable remote stations. This enables: 


e  VM/370 users to have remote job entry access to HASP/ASP-type batch 
processing systems. 


e Remote stations to submit source decks, data, and jobs, on cards, into the 
VM/370 spool system. 


e VM/370 to send spooled output of virtual machine sessions to remote card 
punches and printers. 


e Transmission of card decks between two remote stations supported by RSCS. 
e¢ Remote stations to send job streams to a CMS Batch virtual machine 
(operating under the same VM/370 as RSCS) and have the output returned to 


the originating or another remote station. 


¢ Remote stations to submit source decks, data, and jobs, on cards, to 
another remote location running a HASP/ASP=-type batch processing system. 


e¢ Remote stations to submit data files or a job to any system in the network 
and receive job output at the remote station. 


The following systems support MULTI-LEAVING RJE operation: 


HASP II Version 4 (370H—TX-—001) 
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ASP Version 3.2 (360A-CX-15%xX) 

JES2 Component of VS2 Release 2 and above 
JESS Component of VS2 

RES Component of VS1 Release 2 and above 


Hardware Products Supported 


The following systems are supported by the SML line driver as remote job entry 
Stations into VM/370: 


IBM System/360 Models 20, 22, 25, 30, 40, 50, 65, 75, 85, 195 

IBM System/370 Models 115, 125, 135, 135-3, 138, 145, 145-3, 148, 155, 
155 II, 158, 165, 165 II, and 168, plus the 3031, 3032, 3033, and 
43200 Processors 

IBM 1130 System 

IBM System 3 Models 6, 8, 10, 12, and 15 

IBM 2922 Programmable Terminal 

IBM 3777 Communication Terminal Model 2 (as a System/360 Model 20 
MULTI-LEAVING Workstation) 

IBM System/32 

IBM 8100 


Supported Functions 


The SML line driver operates under the control of the RSCS supervisor in one 
of two modes, specified when the line driver task is initialized: 


JE Mode: The SML line driver functions as a job entry workstation to a 


remote HASP/ASP-—type processor. 


HOST Mode: The SML line driver functions as the host to a remote 
MULTI-LEAVING programmable station. 


Each SML line driver task controls a single communication line, or link. The 
task is started by the RSCS operator, identified with a destination name, and 
provided with a leased or switched telephone line. The communication line is 
identified by the RSCS operator in the START command or derived from a table 
entry in RSCS. On a switched line, a dial-up procedure from either end of the 
line establishes the connection. 


The SML line driver operates with a slightly modified protocol depending on 
its mode. In RJE mode, the type of remote host system, as designated in the 
START command or link parameter information in the RSCS directory, determines 
the protocol to be used. In HOST mode, the SML line driver follows a common 
protocol for all remote stations. 
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RSCS OPERATOR FUNCTIONS: The RSCS operator can: 
e Start and stop the SML line driver task 


e Control the spool files engueued on the RSCS virtual reader in much the 
same Way as the VM/370 system operator controls the spooling functions of 
VM/370 


e Exchange messages with remote stations controlled by the SML line driver 


e Use the TRACE command to monitor activity on the communications line and 
have that data logged on the operator's console 


® Use the CMD command to send allowable workstation commands to the remote 
host system processing the data, if the SML line driver is in RJE mode. 


REMOTE STATION OPERATOR FUNCTIONS: When the remote station is a HASP/ASP 
system (SML line driver in RJE mode), its functions with respect to the SML 
line driver are the same as they Would be for any other HASP/ASP remote 
workstation. It accepts job streams for batch processing or commands 
affecting the processing from the SML line driver and directs job output, in 
punch or printer format, back to the SML line driver. 


When SML is in HOST mode, the remote station operator can: 


e Issue commands to the SML line driver to change the operation of that 
remote station 


e Provide a batch service, transmitting jobs to and receiving output from a 
batch virtual machine (OS, CMS BATCH, VM/370) 


¢ Transmit and receive card decks through the SML line driver to and from 
another remote station supported by RSCS and attached to the same VM/370 
system 


e¢ Transmit jobs and commands to a remote batch system through RSCS using the 
Network Job Interface (NJI) and direct job output to any node or remote 
station in the network. 


VIRTUAL MACHINE USER FUNCTIONS: When the SML line driver is in RJE mode, the 
VM/370 user can submit job streams to a remote HASP/ASP type batch system. 
Punch and/or printer output, returned to the SML line driver, is directed to 
the real printer and punch. 


When the SML line driver is in HOST mode, the VM/370 user can route the output 
of his virtual unit=-record devices to a remote MULTI-LEAVING programmable 
station. He can also have a card deck entered at a remote station and have it 
directed to his virtual machine reader. 


1/0 CONTROL: The SML line driver uses the RSCS supervisor I/O services to 
perform I/O operations on the BSC line to the remote terminal and to control 
the virtual reader and punch. The SML line driver uses the RSCS supervisor 
console support facility to write messages to and receive commands and 
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information from the RSCS operator. 

SML line driver I/O communications comprises five separate operations: 

e Control of the line when the task is idle 

¢ Transmission procedure for sending files to the remote station 

e The procedure for receiving files from the remote station 

e Error analysis and recovery while transmitting to the remote station 

e Error analysis and recovery while receiving from the remote station. 

All I/O operations are executed following the 270x BSC protocol for the type, 
configuration, and features of the remote station as determined at task 
initialization time. 

LINE ALLOCATION: The Line Allocator in the RSCS supervisor allocates an 
appropriate line to the SML line driver during execution of the RSCS START 
command. The line has either been designated by the operator in a START 
command, found in the RSCS link table that contains the valid link 
definitions, or selected by the Line Allocator from a pool of switched lines 
set up at RSCS system generation. When the SML line driver task requests 


termination, the RSCS supervisor automatically indicates that the line can be 
reassigned, effectively deallocating it. 


POW LINE DRIVER 


The POW line driver (DMTPOW), operating as a task under RSCS, provides VM/370 
With binary synchronous communication (BSC) line protocol for remote VSE/POWER 
systems. This allows: 

e VM/370 users to have remote job entry access to VSE/POWER systems. 

e  VM/370 user's to route spooled output to unit=record local devices at the 


DOS/VSE system, RJE devices attached to the VSE/POWER system, or 
unit—record local devices attached to the directly coupled VM/370 node. 


Software Products Supported 


The VSE/POWER software product is supported as a remote system. 
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Supported Functions 


The POW line driver functions as a job entry workstation to a remote VSE/POWER 
system. Each POW line driver task controls a single communication line, POW 
line driver (DMTPOW): task or link. The task is started by the RSCS operator, 
identified with a destination name, and provided with a leased or switched 
telephone line. The communication line is identified by the RSCS operator in 
the START command or derived from a table entry in RSCS. On a switched line, 
a dial-up procedure from either end of the line establishes the connection. 


RSCS OPERATOR FUNCTIONS: The RSCS operator can: 

e Start and stop the POW line driver task 

e Exchange messages with the remote system connected to the POW line driver 
e Use the TRACE command to monitor activity on the communications line 


° Use the CMD command to send allowable VSE/POWER commands to the remote 
system 


VIRTUAL MACHINE USER FUNCTIONS: The POW line driver enables the VM/370 user 
to route the output of his virtual unit=-record devices (a job to be executed) 
to a remote VSE/POWER system. The JECL statements in that job determine the 
later routing of the job output. That is, output from the job is routed 
according to the control statements in the job itself. These statements cause 
the output to be routed to either: 


e Unit record devices locally or remotely attached to the VSE/POWER system, 
or 


e Unit record devices attached to the VM/370 system on Which the submitting 
RSCS virtual machine resides. 


I/O CONTROL: The POW line driver uses the RSCS supervisor I/O services to 
perform I/0 operations on the BSC line to the remote terminal and to control 
the virtual reader and punch. The POW line driver uses the RSCS supervisor 
console support facility to write messages to and receive commands and 
information from the RSCS operator. 

POW line driver I/O communications comprises five separate operations: 


e Control of the line When the task is idle. 


¢ Transmission procedure for sending files to the remote system 


The proceduri: for receiving files from the remote system 
e Error analysis and recovery while transmitting to the remote system 
e Error analysis and recovery while receiving from the remote system 


All I/O operations are executed following the 270x BSC protocol for the type, 
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configuration, and features of the remote system as determined at task 
initialization time. 


LINE ALLOCATION: The Line Allocator in the RSCS supervisor allocates an 
appropriate line to the POW line driver during execution of the RSCS START 
command. The line has either been designated by the operator in a START 
command, found in the RSCS link table that contains the valid link 
definitions, or selected by the Line Allocator from a pool of switched lines 
set up at RSCS system generation. When the POW line driver task requests 
termination, the RSCS supervisor automatically indicates that the line can be 
reassigned, effectively deallocating it. 


NPT LINE DRIVER 


The NPT line driver (DMTNPT), operating as a task under RSCS, provides VM/370 
With support of binary synchronous communication (BSC) line protocol for 
nonprogrammable remote terminals. This allows: 


¢ Remote users of VM/370 to enter source decks, data, and jobs, on cards, 
into the VM/370 spool system 


e VM/370 to send spooled output of virtual machine sessions to remote card 
punches and printers 


e Remote stations to transmit card decks to one another 

e Remote stations to send job streams to a CMS Batch virtual machine 
operating under the same VM/370 and have the output returned to the remote 
station 

e Remote stations to submit jobs or commands to any node in the network and 


direct the output to any node or remote station in the network. The 
default is return to origin. 


Hardware Products Supported 

The following devices are supported by the NPT line driver as remote 
nonprogrammable terminals: 

e IBM 2770 Data Communication System with the 2772 Multipurpose Control Unit 
e IBM 2780 Data Transmission Terminal, Models 1 and 2 


e IBM 3770 Data Communication System (nonprogrammable models) operating in 
2770 BSC mode 
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Note: The 3770 is supported only when its communication line terminates in 
an Integrated Communications Adapter (ICA) on the System/370 Model 135, an 
IBM 2701, or an IBM 3704/3705 Communications Controller. The 3770 keyboard 
is not supported. 


° IBM 3780 Data Communications Terminal 


Supported Functions 


NPT is a line driver task operating under the control of the RSCS supervisor. 
Each NPT task drives one remote nonprogrammable station. In other words, each 
NPT task controls a single point-to-point communications line. The task is 
started by the RSCS operator, identified With a destination name, and provided 
With a leased or switched telephone line. The communications line is either 
identified by the operator or derived from a table entry within RSCS. The 
line is then activated and the type of remote station and its configuration 
details are obtained from control cards entered at the remote station, or from 
a table entry within RSCS. After this initialization is done, the terminal 
may then be used to submit files via the card reader and receive files on the 
punch and printer. 


The remote station operator can control I/0 activity via control cards and 
standard station procedures. The RSCS operator controls the operation with 
commands from his console. The virtual machine user retrieves files sent to 
his virtual machine by using normal virtual card reader management programs 
and directs output to the appropriate station using the SPOOL and TAG commands 
of VM/370. 


NPT operates With variations of the basic BSC protocol for each of the 

Stations listed. The protocol is based upon the station identification 

information provided in a SIGNON card read at task initialization time. 

RSCS OPERATOR FUNCTIONS: The RSCS operator can: 

e Start and stop the NPT line driver task 

e Control the spool files enqueued on the RSCS virtual reader in much the 
Same way as the VM/370 system operator controls the spooling functions of 
VM/370 


e Exchange messages with remote terminals controlled by the NPT line driver. 


Activity on the communications line controlled by the NPT line driver is 
logged on the RSCS operator's console. 


REMOTE TERMINAL OPERATOR FUNCTIONS: The remote terminal operator can: 


e Issue commands to the NPT line driver to change the operation of his 
terminal 


e Provide a batch service, transmitting jobs to and receiving output from a 
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batch virtual machine such as CMS BATCH 


e¢ Transmit and receive card decks, through the NPT line driver, to and from 
another terminal supported by RSCS and attached to the same VM/370 system 


e Transmit jobs, data files, or commands to any node on the network and 
direct job output to any node or workstation on the NJI network. 


VIRTUAL MACHINE USER FUNCTIONS: The virtual machine user can: 


e Route the output of his virtual unit-record devices to a remote 
nonprogrammable terminal 


e Have a card deck entered at a remote nonprogrammable terminal and have it 
queued on his virtual machine reader 


e Submit a job through RSCS from his terminal and have the output directed 
back to a remote station. 


I/O CONTROL: NPT uses the RSCS supervisor I/0 services to perform I/0 
operations on the BSC line to the remote terminal and to control the virtual 
reader and punch. NPT uses the RSCS supervisor console support facility to 
write messages to and receive commands and information from the RSCS operator. 


NPT communications I/O comprises five separate operations: 

e Control of the line When the task is idle. 

e¢ Transmission procedure for sending files to the remote station 

e The procedure for receiving files from the remote station 

e Error analysis and recovery while transmitting to the remote station 
e Error analysis and recovery while receiving from the remote station 


All I/0 operations are executed following the 270x BSC protocol for the type, 
configuration, and features of the remote terminal as determined at task 
initialization time. Separate send and receive buffers provide for the 
interruption of long output files to allow the input of cards or commands. 
When the input transmission is completed, output transmission is resumed from 
the point of interruption. If the transparency feature is available, 
transmission to a remote punch device is performed in transparency mode. 
Transmission to a remote printer is alWays performed in nontransparency mode 
With elimination of trailing blanks in each record. Print files are always 
translated in order to eliminate illegal characters that would force a 
transparent wait state on a teleprocessing control unit in nontransparency 
mode. 


LINE ALLOCATION: The Line Allocator in the RSCS Supervisor allocates an 
available line to NPT as part of the execution of the RSCS START command. The 
line has either been designated in the START command, found in the RSCS link 
table, or selected by the Line Allocator from a pool of switched lines set up 
at system generation of RSCS. When the NPT taSk requests termination, the 
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RSCS supervisor automatically indicates that the line can be reassigned, 
effectively deallocating it. 


RPT LINE DRIVER 


The RPT line driver (DMTRPT) provides spooling support for the IBM 3270 
Information Display System printers, Which can be attached to a host CPU 
either locally or at a remote node. The printers are identified to RSCS as 
virtual devices either by the operator issuing a privileged command, or by 
means of the DEDICATE statement in the VM/370 directory entry for the RSCS 
virtual machine. 

DMTRPT performs the general functions of a line driver task, such aS managing 
I/O to the printer's virtual device address, managing spool file data 


transmissions, and executing command alert elements. 


DMTRPT converts VM/370 spool files to 3270 data streams before transmitting 
them to the printer. This involves: 


e Prefixing each buffer that is to be transmitted with a WCC (Write Control 
Characters) SBA (Set Buffer Address) sequence. 


e Moving each data record from the spool file to the 3270 buffer, and 
following it with a sequence (depending on the CCW op-code) of New Line 


(X'15*) characters. 


e Translating unprintable characters to blanks, and removing blank strings 
and converting them to RA (Repeat to Address) orders. 


e Locating and adjusting APL or Text compound characters to print correctly 
on the particular printer in use. 


Hardware Products Supported 

DMTRPT supports the following devices as IBM 3270 Information Display System 
printers: 

© IBM 3284 Printer, Models 1 and 2 

© IBM 3286 Printer, Models 1 and 2 

e IBM 3287 Printer, Models 1, 2, 1C, and 2C 

¢ IBM 3288 Line Printer, Model 2 

¢ IBM 3289 Line Printer, Models 1 and 2 


° IBM 3262 Printer, Models 3 and 13 
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| Note: For the 3287, models 1C and 2C, only the base color is supported. 


| Features Supported 


The following features are supported when installed on the applicable control 
unit and/or printer: 


| © 1066 Data Analysis-APL (3284 Model 2, 3286 Model 2, 3287) 
| © 1120 APL/Text (3287) 

| * 9550 Page Length Control 

| e 9850 Vertical Forms Control 


Note: The 10 graphic plot characters available on the 32387 Models 1 and 2 
With the APL/Text feature are not supported since there are no EBCDIC 
equivalents for these characters defined by VM/370. 


VMB LINE DRIVER 


The VMB line driver (DMTVMB) is for transmitting VM/370 spool files between 
VM/370 systems over BSC lines. DMTVMB communicates With another copy of 
itself using the file address specified on the VM/370 TAG command (location 
and userid) to determine the recipient virtual machine. DMTVMB supports both 
print and punch file transmission between users operating on two different 
VM/370 machines or transmission from a VM/370 user to a real unit—record 
device on a remote VM/370 machine. DMTVMB requires no special operating 
instructions and supports the full RSCS command language except for BACKSPAC, 
HOLD IMMED, and FWDSPACE commands. 


VMC LINE DRIVER 


The VMC line driver (DMTVMC) is for transmitting VM/370 spool files between 
VM/370 systems over channel=to-channel adapters (CTCAs). DMTVMC passes VM/370 
4K spool page buffers to another copy of itself, using a specially designed 
protocol to optimize utilization of the CTCA without creating heavy 1/0 
activity. The 4K block is read from the VM/370 spool system, transmitted 
across the CTCA, and then written into the receiving machine's spool system 
With minimal SIO execution. Like DMTVMB, DMTVMC requires no special operating 
instructions, and supports the full RSCS command language except for BACKSPAC, 
HOLD IMMED, and FWDSPACE commands. 
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NJI LINE DRIVER 


The DMTNJI line driver is for use between RSCS and NJI/NJE compatible 
subsystems using BSC lines or CTCAs. These subsystems include HASP II Version 
4.0, ASP 3.2, JES2/NJE, and JES3/NJE. DMTNJI supports the same types of file 
transmissions as DMTVMB. It also requires no special operating instructions 
and supports the full RSCS command language except for BACKSPAC, HOLD IMMED, 
and FWDSPACE commands. 


VMB/VMC/NJI COMMON FACTORS 


These line drivers, operating as RSCS tasks, provide for communication between 
RSCS and NJI/NJE compatible subsystems, as Well as between RSCS and other 
VM/370 systems using RSCS, over BSC lines and CTCAs. This enables VM/370 
users to: 


e Submit jobs to a remote batch processor for execution 


e Direct the output from a job to any remote system or back to the user’s 
virtual machine reader 


e Route output to a remote batch system for processing and use special forms 
and output processing routines available at that system. 


Software Products Supported 


The following software products are supported as remote systems: 


VM/370 RSCS Networking Program Product 5748-XP1 

VM/370 Networking (VNET) PRPQ 5799-ATA 

JES2 Network Job Entry Facility Program Product 5740-XR8 
JES3S/NJE PRPQ 

ASP Networking PRPQ 5799—ATB 

HASP Networking PRPQ 5799-ATC 


Supported Functions 


The NJI/VMB/VMC line driver tasks operate under the control of the RSCS 
Supervisor. Each task can communicate with one remote system; that iS; each 
task controls one communication adapter, either a BSC line or a CTCA. 


RSCS OPERATOR FUNCTIONS: The RSCS operator can: 


e Start and stop the line driver task 
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e Control the spool files enqueued on the RSCS virtual reader in much the 
same Way as the VM/370 system operator controls the spooling functions of 
VM/370 


e Send commands and/or messages to any other remote system connected via the 


line driver. 


REMOTE SYSTEM OPERATOR FUNCTIONS: The remote system operator can issue 
commands to effect the operation of the file transfer to his location at the 
directly connected system. 


VIRTUAL MACHINE USER FUNCTIONS: The virtual machine user can: 


e Route the output of his virtual unit-record output devices to any remote 
system for processing 


e Submit a file to execute as a job at a remote batch system 


e Receive a file entered at a remote system's real card reader into his 
virtual machine reader 


e Have output from a job executed at a remote batch system returned to his 


virtual machine reader, under user control, when this function 18S supported 
by the remote batch system. 
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Job Output Routing Overview 


IBM operating systems today have different capabilities for job output 
routing. Although they do not as a group provide full job output routing, 
they do provide considerable routing capability. These capabilities are 
illustrated in Figures 5 and 6. 


SYSTEM 1 SYSTEM 2 
d/ 
VIRTUAL RSCS SPOOLING 
MACHINE JOB INTERFACE 
OUTPUT 
< TY 
7 V 
VM/370 CP OTHER NODES 
IN THE 
NETWORK 


UNIT RECORD UNIT RECORD 


DEVICES (URI) DEVICES (CUR2) 


Figure 5. Job Output Routing Capabilities in a Network 


Figure 6 defines output routing options available with the network 
configuration illustrated in Figure 5. A user in the System 1 environment 


sends a job to System 2 for execution. Upon completion of the job, the System 
2 Spooling Interface can typically direct the output (print or punch) to one 


of the following: 

¢ System 2 unit-record devices (UR2) 
e System 1 unit-record devices (UR1) 
e Any network—defined node and userid 


The routing capabilities of the different spooling interfaces are briefly 
summarized in Figure 6. 
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SYSTEM 2 
OPERATING 
SYSTEM 


DOS/VSE VSE/POWER 


ESSE 


JES3Z/NJE 
SVS,MFT, 


or MVT 


SYSTEM 2 
SPOOLING 
INTERFACE 


OUTPUT ROUTING 
OPTIONS 


METHOD OF ROUTING 


System 1 — UR] Default. No action 


required by the user. 


System 2 — UR2 


Place in JECL: 
* SS LST REMOTE=-0 


or 


* $9 PUN REMOTE=0 


Place in JCL: 
/*xROUTE nodeid.userid 


Any nodeid and 
in network 


userid 


ASP/NJI or 
HASP/NJI 


Place in JCL: 
/*ROUTE nodeid.userid 


Any nodeid and 
userid in network 


Default. No action 
required by the user. 


OS/VS1 RES System 1 — URI 


Place in JCL: 
DEST=CENTRAL 


System 2 — UR2 


VM/370 RSCS 
(See Note) 


SPOOL and TAG device 
or file 


Any nodeid and 
userid in 
network when 
CMS batch 
receives job 


Default. 
required of the user. 


System 2 — UR2 No action 
when any other 
batch machine 


receives job 


Note: This final case applies Whenever VM/370 is the executing 
system. That is, if the execution 1S done by a CMS batch 
machine, the output can be routed anywhere in the network. 
Otherwise the output must be directed to the real unit 
record devices of the executing system; it cannot be routed 
back to the originating system. 


Figure 6. Job Output Routing Options in a Network 
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Part 2: RSCS Installation 


Part 2 describes the elements involved 
in instllling an RSCS virtual machine. 
the two main areas discussed are: 


¢ Planning to Install RSCS 


e Installing RSCS 


Part 2: RSCS Installation 2-1 


/ 


Planning to Install RSCS 


This section describes how to create the RSCS directory, Which defines your 
local RSCS system and its view of the network in Which it participates. This 
section also provides guidelines for selecting line drivers for a particular 
application. 


HE RSCS DIRECTORY 


Each RSCS location must specify the local definitions and options for its 
operation. To do so, the RSCS system programmer builds a directory file with 
filename and filetype of RSCS DIRECT. This file must reside on the RSCS 
system disk when RSCS is IPLed. As part of its initialization, RSCS reads the 
RSCS DIRECT file and builds its system control blocks accordingly. 
Installation variable information need not be specified with an RSCS system 
load. 


A location may need to make minor changes to its RSCS directory on a normal 
day to day basis. It might be convenient to allow multiple write access to 
the RSCS system disk to update the RSCS directory (Cand the PROFILE RSCS 
initial command file), taking precautions to avoid concurrent multiple access 
while writing the RSCS system disk. Because RSCS never writes its system 
disk, and RSCS reads its system disk only during execution of operator 
commands, the directory may be updated during production RSCS operation, and 
tested by simply IPLing the RSCS system disk in the virtual machine used for 
editing the updates. When this is done, the changes become effective on the 
next RSCS virtual machine IPL. (Link and route definitions may normally be 
made immediately effective by use of the RSCS operator DEFINE, DELETE, and 
ROUTE commands.) 


RSCS maintains information about directly connected locations in its link 
table entries, and each indirectly connected location and its next direct link 
in routing table entries. RSCS builds link and routing tables during 
initialization, according to the directory specifications. RSCS also 
generates sixteen null link entries and sixteen null route entries, which may 
be used to dynamically define links and routes during RSCS operation by use of 
the DEFINE and ROUTE commands. 


RSCS accepts and enqueues a file for transmission if an empty tag slot is 
available; otherwise, the file is left pending, and cannot be managed through 
the RSCS command language. Pending files increase operating overhead and are 
awkward to deal with in general. The provision for pending files is to manage 
an abnormal situation as gracefully as possible; a location should seek to 
avoid that operating circumstance. 


RSCS builds its tag slots during its initialization. The number of tag slots 


built is at least as great as the sum of the tag slots reserved for exclusive 
use by links in the keep operands of the LINK directory control statements. 
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More extra tag slots may be generated, up to a limit which depends on the size 
of the RSCS virtual machine's virtual storage. This limit iS computed as one 
tag slot per 1024 bytes of virtual storage. Extra tag slots may be requested 
by means of the TAGS directory control statement. The number of extra tag 
slots requested on the TAGS statement is added to the sum of the links’ 
reserved tag slots, up to the virtual storage limit. If no TAGS statement is 
included in the directory, a default request of one extra tag slot per 2048 
bytes of virtual storage is assumed. 


RSCS DIRECTORY CONTROL STATEMENTS 


RSCS directory control statements must be in the following formats, with one 
or more blanks as operand delimiters. All operands are positional from left 
to right. If any operand is omitted, all operands to the right of that 
operand in the statement must be omitted also. Operands may be entered in 
columns 1 through 71. All data entered to the right of column 71, and all 
data entered to the right of the last possible operand are ignored. No 
continuation of RSCS directory control statements is provided. Entirely blank 
records, and records having an asterisk (%) in column 1 are ignored, allowing 
these lines to be used for comments and print formatting. 


The directory control statements must be grouped sequentially by type as 
follows: 


Statement Number 
Sequence Required 


Defines the local installation’'s location 
identifier (Clocid). 


Defines the attributes of the links attached 
to the local installation. 


Defines the line driver initialization 
default parameters. 


Defines the (next) link to be used for 
indirect routing. 


Defines the allocatable switchable 
telecommunication ports attached to the 
local installation. 


Defines the number of extra tag slots to 
reserved. 


Planning to Install RSCS 2-3 


Example: A simple RSCS directory might appear as follows: 


% DEFINE RSCS INSTALLATION VARIABLES 

LOCAL RSCSSYS 7 

LINK CAMBRIDG DMTVMB 0384 5 

LINK TDCSYS1 DMT VMB 096 5 TDCl x 8 
LINK WORKSTA1 DMTSML * 7 WSl «x 4 
P ARM WORKSTAI Ml 

ROUTE PALOALTOQ CAMBRIDG 

ROUTE TDCSYS2 ToCcSYS1 

ROUTE WCCSYS10 CAMBRIDG 

ROUTE WCCOSYS11 CAMBRIDG 

PORT 036 

PORT 087 

TAGS 512 


If a directory control statement 1s found to be in error during RSCS 
Initialization, RSCS displays the erroneous statement and a diagnostic error 
message on the RSCS operator’s console, ignores the erroneous statement, and 
continues initialization. 


LOCAL Control Statement 


LOCAL defines the location identifier and time zone of the local RSCS system. 
LOCAL must appear before all other control statements in the RSCS directory, 
and it must appear exactly once. 


locid is the one- to eight-character location identifier used to address 
the local RSCS installation. It should be unique among all 
potentially interconnected locations. 


zone specifies the number of time zone boundaries between the local 
location and Greenwich to the east, the International Date Line 
being included as a time zone boundary. The zone number is used to 
convert local date and time to and from System/370 time of day 
format. Valid zone numbers range from decimal zero through 24. If 


zone is not specified, or is specified as *, a default value of zero 


(Greenwich Mean Time?) is assumed. 
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LINK Control Statement 


LINK defines the attributes of a single RSCS link. Link attributes thus 
defined apply to the link when it i5 activated, unless overriden by START 
command parameters. 


The LINK statement must immediately follow a LOCAL statement or another LINK 
statement in the RSCS directory. 


linkid driverid port zone task class keep 


*% x x x x x 


linkid is the one— to eight-character link identifier for the link being 
defined. 


driverid specifies the name of the line driver to be used for communication 
on the link. driverid is the one— to eight-—character CMS file name 
of the TEXT file to be loaded and executed as the link’s line driver 
program (such as DMTNJI, DMTNPT, DMTPOW, DMTRPT, DMTSML, DMTVMB, or 
DMTVMC). The proper line driver to use with the link depends on the 
type of remote telecommunications system involved. If driverid is 
not specified, or is specified as *, a default value of undefined is 
assumed, and the line driver type must be specified when the link is 
activated by a START command. 


port specifies the virtual device address (hexadecimal cuu) of a 
permanent telecommunications port to be used for communication on 
the link being defined. Valid virtual device addresses are 
hexadecimal 2 through 5SFF. If port is not specified, or is 
specified as *, a default value of undefined is assumed, and the 
port address must be specified when the link is activated. 


zone specifies the number of time zone boundaries between the link'’s 
remote location and Greenwich to the east, the International Date 
Line being included aS a time zone boundary. The zone number is 
used to convert System/370 time of day to date and time for use in 
messages to the remote location. Valid zone numbers range from 
decimal zero through 24. If zone is not specified, or is specified 
as *, a default value of zero (Greenwich Mean Time) is assumed. 


task specifies a task name for use by the line driver program. Each RSCS 
task must have a unique task name While it is active. Attempts to 
activate a link using a task name identical to the task name of a 
concurrently active task Will fail with an error diagnostic message. 
Valid task names are one—- to four-—character alphameric names. Task 
names reserved for RSCS system control tasks are REX, AXS, and LAX. 
If task iS not specified, or is specified as *, the task name 
defaults to the first four characters of the specified linkid. 
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class specifies the classes of files which may be transmitted by the link. 
A valid class specification iS a one— to four-—character word, each 
character of which is one of the YM/370 spool classes A through Z 
and 0 through 9. Files will be transmitted in class order, left to 
right. If class is not specified, or is specified as *, a default 
class of * is assumed, allowing files of all classes to be 
transmitted. 


keep specifies the number of virtual storage file tag slots to be 
reserved for exclusive use by the link. Valid keep specifications 
are decimal numbers from zero to sixteen. If keep is not specified, 
or 1S specified as *, a default keep specification of two is 
assumed. 


PARM Control Statement 


PARM defines a default parameter string of arbitrary text information to be 
made available to a line driver when a link is activated by a START command. 
The parameter string is generally used to specify processing modes or other 
options to a line driver; its format and content depend on the type of line 
driver. The parameter string specified in the PARM statement may be 
overridden by the PARM parameter on the START command. 


The PARM statement must follow a LINK control statement or another PARM 
statement. The PARM statement must refer to a link Which is defined by a 
previous LINK statement, and only one PARM statement may be included in the 
RSCS directory for a particular link. 


PARM linkid [parmtext ] 


linkid is the one-— to eight-character identifier of the previously defined 
link to which the parameter string is to apply. 


parmtext iS any arbitrary character string, bounded by the leftmost and 
rightmost nonblank characters, which provides initialization 
information to a line driver at link activation time. 


ROUTE Control Statement 


ROUTE defines a remote location with which the local RSCS installation may 
communicate indirectly through one or more interconnected locations. A ROUTE 
statement specifies the location ID for a single remote location, and the link 
ID of the link on which transmissions destined for that remote location are to 
be made. 


A ROUTE statement must follow a LINK or PARM statement, or another ROUTE 
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statement. The link ID specified in the ROUTE statement must have been 
defined in a preceding LINK control statement. 


ROUTE locid linkid 


locid is the one— to eight-—character location identifier of the remote 
location which is being defined for indirect communication. 


linkid is the one- to eight-—character link identifier of the link on which 
transmissions destined for the remote location are to be made. This 
link must have been defined by a preceding LINK statement. 


PORT Control Statement 


PORT specifies a single switched BSC port that may be dynamically allocated 
for communication with a remote location at link activation time. 
Telecommunication ports may be defined for use With a particular link ina 
LINK statement in the RSCS directory, or as the object of a LINE keyword in a 
START command. If the port is not defined by either means, RSCS searches for 
an available switched port that has been defined by the PORT control statement 
in the RSCS directory. If one is found RSCS assigns it to the newly activated 
link, and notifies the operator of the assignment. 


A PORT statement must follow the LOCAL control statement, and any LINK, PARM, 
or ROUTE statement, or another PORT control statement. 


vaddr specifies the virtual device address (hexadecimal cuu) of a switched 
(dialable) telecommunications port that may* be dynamically allocated 
for communication to a remote location to which no leased line 
connection exists. Valid virtual device addresses are hexadecimal 
002 through 5SFF. 


TAGS Control Statement 


TAGS allows the RSCS installation to request extra tag slots to be used to 
enqueue files for transmission. When RSCS receives more files for 
transmission than can be enqueued in its available tag slots, the files are 
made pending. Pending files cannot be managed through the RSCS command 
language. 


The maximum number of tag slots that can be generated is computed as the size 
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of the RSCS virtual machine's virtual storage divided by decimal 1024 (one tag 
slot per K of virtual storage). The sum of the tag slots specified to be kept 
in link definitions plus the number of extra tag slots requested in the TAGS 
control statement are generated at RSCS initialization, up to the maximum 
number of tag slots. If the number of extra tag slots requested in the TAGS 
statement exceeds the maximum, the maximum number of tag slots is generated 
and a diagnostic error message is issued. Otherwise, if the sum of the link 
keep specifications plus the request from the TAGS statement exceeds the 
allowable maximum, the maximum number of tag slots is generated and no 
diagnostic error message is issued. 


The TAGS statement must follow the LOCAL control statement, or a LINK, PARM, 
ROUTE, or PORT statement. The TAGS statement may be specified only once or 
omitted. 


nnannn specifies the decimal number of extra tag slots requested to be 
generated at RSCS initialization time. This number represents the 
greatest number of files which may be concurrently enqueued in 
addition to those enqueued using tag slots specified to be kept in 
LINK control statements, assuming RSCS virtual storage is 
sufficiently large to avoid truncation of tag slot generation. 
Valid requests for extra tag slots range from decimal 1 through 
16384. A fixed-length block of virtual storage must be reserved for 
each tag slot generated at RSCS initialization. 


RSCS DIRECTORY EXAMPLES 


To aid in the definition of your RSCS system this section illustrates minimum 
RSCS directory examples for three simple networks. Each example presents the 
directory contents as viewed by each node in the network. 


Figure 7 shows the simplest form of a job network consisting of two VM/370 
systems connected via a teleprocessing line. This network contains two 
locations, CHICAGO and BUFFALO. The directory at location CHICAGO shows a 
LOCAL entry defining the location and the relative time zone of CHICAGO to 
Greenwich Mean Time (GMT). The LINK statement shows a direct communication 
path to location BUFFALO. This statement also defines the line driver type to 
be used for communication with BUFFALO. Note that this must match the line 
driver type shown on the LINK CHICAGO defined at location BUFFALO. The 
directory at location BUFFALO reflects a mirror image of the directory at 
CHICAGO, showing a LOCAL entry of BUFFALO and a direct communication path 
(LINK) to CHICAGO. 
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. CHICAGO BUFFALO 
<----> 


LOCAL CHICAGO 6 LOCAL BUFFALO 5 
LINK BUFFALO DMTVMB 5 LINK CHICAGO DMTVMB 6 


Figure 7. Two-Node Simple Network 


Figure 8 shows a three-node network consisting of three VM/370 RSCS systems 
interconnected via two telecommunications lines. Files destined for location 
MIAMI originating at CHICAGO must be stored and forwarded through location 
ATLANTA. The view of the network at location CHICAGO shows one direct 
communications path (LINK) to ATLANTA and one indirect communication path 
(ROUTE) to MIAMI through ATLANTA. The view of the network from ATLANTA shows 
direct paths (LINKS) to both CHICAGO and MIAMI, so no ROUTE statements are 
necessary. Location MIAMI shows a direct path to ATLANTA and an indirect path 
to CHICAGO through ATLANTA. 


ATLANTA 
<---> <———> 


LOCAL CHICAGO 6 LOCAL ATLANTA 5 LOCAL MIAMI 5 
LINK ATLANTA DMTVMB 5 LINK CHICAGO DMTVMB 6 LINK ATLANTA DMTVMB 5 
ROUTE MIAMI ATLANTA LINK MIAMI DMTVMB 5 ROUTE CHICAGO ATLANTA 


Figure 8. Three-Node Store and Forward Network 


Figure 9 shows a four=node VM/370 network interconnected via three 
telecommunications lines and one channel-to-channel adapter. This illustrates 
alternate paths between two nodes in a network. RSCS provides for the 
definition of a direct path plus one indirect path to a given location. 
However, use caution in specifying the network definitions when multiple paths 
exist; specify the indirect path only on one end of the network connection. 


For example, assume the CHICAGO directory contains an alternate path (ROUTE) 
to BOSTON via TORONTO and the TORONTO directory contains a route to BOSTON via 
CHICAGO. If the CHICAGO—BOSTON and TORONTO-—BOSTON direct links become 
inactive, a file destined for BOSTON would begin to loop. It would be 
continually transmitted between CHICAGO and TORONTO until a link from either 
location to BOSTON became active. Therefore as shown in Figure 9, the 
indirect path (ROUTE) to BOSTON is specified only at CHICAGO. 
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Similar examples could be shown for other paths in the sample network. Close 
coordination is necessary among the individual installations when defining a ) 
multi=-system network. 


BOSTON 
< > 
(BSC CONNECTIONS) 
< > 
LOCAL CHICAGO 6 LOCAL BOSTON 5 
LINK BOSTON DMTVMB 5 LINK CHICAGO DMTVMB 6 
LINK TORONTO DMTVMB 5 LINK TORONTO DMTVMB 5 
ROUTE BOSTON TORONTO ROUTE TORONTO CHICAGO 
ROUTE NORTH TORONTO ROUTE NORTH TORONTO 
V V 
TORONTO CTCA NORTH 
<—-//—> 
LOCAL TORONTO 5 LOCAL NORTH 5 ~—/ 
LINK BOSTON DMTVMB 5 LINK TORONTO DMTVMC 5 
LINK CHICAGO DMTVMB 6 ROUTE BOSTON TORONTO 
LINK NORTH DMTVMC 5 ROUTE CHICAGO TORONTO 


ROUTE CHICAGO BOSTON 


Figure 9. Multi-Node Mesh Connected Network 


LINE DRIVER SELECTION 


RSCS manages many differing protocols among different links. The line driver 
used on a particular link must be compatible with the protocol used by the 
remote node. 


e DMTSML supports a MULTI~LEAVING remote workstation attached to RSCS; such 
workstations include 1130, System/3, System/360, System/370, and 
System 360/Model 20 systems used as workstations. DMTSML also 
supports the remote job entry of jobs into batch systems not 
supporting a job networking interface. 


e¢ DMTPOW supports VM/370 as a workstation to VSE/POWER host systems over BSC 


lines. ) 


e DMTNPT supports a 2770, 2780, 3770, or 3780 as a remote workstation to RSCS. 
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e DMTRPT supports the IBM 3270 Information Display System printers (32384, 
3286, 3287, 3288, 3289, and 3262 Models 3 and 13) at either the local 
or a remote node. 


e DMTVMB supports VM/370 to VM/370 communications over BSC lines. 


e DMTVMC supports VM/370 to VM/370 communications over a channel—to-channel 
adapter (CTCA). 


e DMTNJI supports communications between RSCS and non-VM/370 Network Job 
Interface / Network Job Entry systems via BSC lines or a CTCA. Such 
systems include HASP II Version 4.0, ASP 3.2, JES2/NJE, and JES3/NJE 
systems. " 


INSTALLATION CONSIDERATIONS 


USE OF TWO-LEVEL REMOTE ADDRESSING 


The destination address structure in RSCS allows for the use of a two-level 
network address. This feature allows for a locally defined link to be 
addressed from other locations without having to be defined throughout the 
network. When a file 1S received at a destination RSCS location, the userid 
parameter on the initial user TAG command is first checked against valid links 
defined at that location. If a matching link ID is found, the file is then 
routed to that locally defined link. If no link ID match is found, the file 
Will be spooled to the specified virtual machine user ID. 


Note: If a user ID is identical to a link ID at its RSCS location, any 
attempt to address a file to that user ID causes the file to be transmitted on 
the link and produced as real output at the directly connected remote station. 
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Installing RSCS ) 


GENERAL INFORMATION 


The RSCS Networking program product is distributed on one or two tapes that 
contain the data and control files needed to generate and install RSCS 
Networking. You Will always receive a base tape; you may also receive a 
service tape, if one is available at the time you ordered the product. 


The RSCS Networking base tape contains six files: 


Lg 


6. 


An installation EXEC to load the rest of the base tape, a sample 
directory, and a sample profile. 


All data and tools required to generate and run RSCS. This includes a 
nucleus loadlist, a control file, and text decks. 


The tools required for servicing and making local updates to RSCS. 
All RSCS module source code. 


RSCS macro library. ) 


All RSCS macro and copy source code. 


The RSCS Networking service tape contains ten files: 


| lf 


ra 


10. 


Memo to user. 


Product information and a service EXEC to load the rest of the service 
tape. 


Replacement text decks. 

Auxilliary files for source code updates. 
Source code updates. 

Auxilliary files for macro/copy updates. 
Macro/copy updates. 


Source code for modules or macro/copy files that are not on the RSCS 
base tape. 


Complete replacement of RSCS macro library if macro/copy file updates 


exist. ) 


New or updated tools for servicing RSCS. 
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DEFINING YOUR RSCS VIRTUAL MACHINE 


CT EE EN? TROIS 


You need the RSCS virtual machine defined when you generate RSCS. This 
machine must have at least: 


e 384K of virtual storage 
e An operator's console 
e Recommended DASD storage for the RSCS system disk is one of the following: 
- 6 cylinders on a 2314 
- 3 cylinders on a 3330 
- 8 cylinders on a 3340 
- 2 cylinders on a 3350 or 3380 
- 1536 FBM blocks on a 3310 or 3370 


If you did not include an entry in your VM/370 directory for the RSCS virtual 
machine, you must add one‘now. Refer to the VM/370 Planning and System 
Generation Guide for information on the directory program, including the 
control statements necessary to define a virtual machine. Add the newly coded 
directory entry to the existing CP directory file and load the new VM/370 
directory. 


A sample VM/370 directory entry for an RSCS virtual machine is: 


USER RSCS password 512K 
ACCOUNT NUMBER BIN17 
OPTION ACCT 

IPL 191 

CONSOLE O09 3215 

SPOOL C 2540 READER A 
SPOOL D 2540 PUNCH A 
SPOOL E 1403 A 

LINK CMSSYS 190 190 R 
MDISK 191 3330 81 5 UDISK1 W rpassword Wpassword 
DEDICATE 078 078 
DEDICATE 079 079 
DEDICATE O7A O7A 
DEDICATE 570 570 
DEDICATE NET 1001 390 


If you specify the ACCT option, RSCS accounting records will be generated 
along With other CP accounting card records. If you don’t want RSCS 
accounting information, exclude the OPTION and ACCOUNT cards from the RSCS 
directory entry when defining the RSCS virtual machine. If you don’t want 
automatic IPL upon LOGON, remove the IPL directory control statement. If you 
Want automatic IPL and the RSCS system disk is at an address other than 191, 
code the IPL statement to specify the virtual disk adddress to be used. 


Installing RSCS 2-13 


specified virtual storage, the greater the number of line drivers that may be 
concurrently active, and the greater the number of default tag slots that will 
be generated at RSCS initialization. 


RSCS adapts to any virtual storage size of 384K or greater. The larger the } 


The ECMODE option is not required and not recommended for the RSCS virtual 
machine. It 1s recommended that privilege class G be specified; others, 
except class D, may be specified. 


GENERATING RSCS 


Before you generate RSCS, be sure you have: 


The RSCS distribution tapes 

e A VM/370 directory entry for your RSCS virtual machine 

e A191 disk defined for your RSCS virtual machine 

e A194 disk defined for your MAINT virtual machine for staging RSCS text 

e A 394 disk defined for your MAINT virtual machine for keeping RSCS source 


e A 294 disk defined for your MAINT virtual machine for staging RSCS service, } 
only if you have also received a service tape 


e A VM/370 directory entry for the MAINT virtual machine as provided in the 
VM/370 starter system directory. RSCS uses the MAINT virtual machine and 
its 190 and 191 disks When building the RSCS system. 


You can use a 2314, 3330, 3340, 3350, 3310, 3370, or 3330 disk as the RSCS 
system disk. 


The following system generation procedure for RSCS assumes you have the MAINT 
virtual machine supplied With the VM/370 starter system in your VM/370 
directory. 


If you Wish to generate and run the RSCS Networking program product and the 
RSCS component of VM/370 concurrently, take care to isolate the installation 
and maintenance files of the two subsystems on two separate user disks. 
Module names, libraries, and update procedures are similar for the two 
subsystems. If their data areas are not kept separate, the results are 
unpredictable. 


STEP 1. LOGON AS MAINT AND IPL CMS 


To build the RSCS nucleus, logon the software system support virtual machine = 
(MAINT) and IPL the CMS system. 
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LOGON MAINT 
IPL 190 CLEAR 


Files 1 and 2 of the RSCS base tape contain all the files necessary to 
construct a standard RSCS. No assemblies are required to install RSCS unless 
you want to make local modifications. The instructions on the following pages 
describe the simplified installation procedure for an unmodified RSCS. If you 
want to include local modifications in your RSCS system, use this description 
and the section "Updating RSCS”. 


STEP 2. ATTACH THE RSCS TAPE 


Mount the RSCS base tape, and attach the real tape drive to your CMS virtual 
machine (MAINT) in the following manner: 


CP ATTACH 280 TO MAINT AS 181 CRSCS base tape) 
CP REWIND 181 


With the MAINT 191 disk accessed read/write as MAINT’s CH-disk, rewind and load 
the first file on the base tape: 


ACC 191 C 
TAPE LOAD x * C 


This puts the EXEC (for loading the rest of the tape), the sample profile, and 
the sample directory on the MAINT 191 disk. 


CMS responds with the following message: 


LOADING... 

RSCSBASE EXEC 

SAMPLE DIRECT 

PROFILE SAMPLE 

END-—-OF-FILE OR END-—OF-TAPE 


STEP 3. LINK TO THE RSCS MINI DISK 
If you use the sample VM/370 directory entry for the RSCS virtual machine, 
your CP LINK command is: 

LINK TO RSCS 191 AS 195 W PASS= Wpassword 
This makes the RSCS system disk (address 191 in the RSCS virtual machine) 
available at virtual address 195 in the MAINT virtual machine. Remember the 
address you specify for MAINT. You must use this Same virtual address later 


in the RSCS generation procedure (when you build the RSCS nucleus in Step 7). 


If an RSCS system disk has already been defined and formatted, access it as 
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your A-disk (ACCESS 195 A) and then skip to step 4. Otherwise, format the 
RSCS system disk using the following command: ) 


FORMAT 195 a 


Note: The option (BLKSIZE nnnn) may be included in the FORMAT command if your 
VM/370 system includes the VM/Basic Systems Extensions program product, 
Release 2, VM/Systems Extensions program product, Release 2, or VM/System 
Product. (These program products include the CMS Enhanced Disk Format 
feature, which permits a blocksize of 1024, 2048, or 4096 bytes to be 
specified in the FORMAT command.) 


, 


The system then issues the message: 


FORMAT WILL ERASE ALL FILES ON DISK ‘*A(C195)"°. 
DO YOU WISH TO CONTINUE? (YES/NO): 


Reply yes. The system then issues the message: 

ENTER DISK LABEL: 
Reply with the label to be assigned to the RSCS system disk, such, as RSCSA. 
The system then issues the messages: 


FORMATTING DISK ‘A*. 
™r' {CYLINDERS|BLOCKS} FORMATTED ON 'AC(195)°. ) 


This signifies that the initial formatting of the RSCS system disk is 
finished. 


Next, format the RSCS system disk again. You must use the recompute function 
of the FORMAT command to make the last cylinders of the RSCS system disk 
unavailable to the CMS file system. If the RSCS system disk is a 2314 or 
3340, the last two cylinders are needed for the nucleus. For a 3330, 3350, or 
3380, only the last cylinder is needed. For a 3310 or 3370, 512 blocks are 
needed for the nucleus. 
The FORMAT command for a 2314 RSCS system disk is: 

FORMAT 195 a & Crecomp 
The FORMAT command for a 3330 RSCS system disk is: 

FORMAT 195 a 2 (Crecomp 
The FORMAT command for a 3340 RSCS system disk is: 


FORMAT 195 a 6 (recomp 


The FORMAT command for a 3350 or 3380 system disk is: 


FORMAT 195 a 1 (recomp | ) 
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The FORMAT command for a 3310 or 3370 system disk is: 


FORMAT 195 a 1924 Crecomp 


STEP 4. MODIFY THE SUPPLIED RSCS DIRECTORY 


You can use the CMS Editor to modify the supplied RSCS directory 

CSAMPLE DIRECT Cl) to describe your local RSCS configuration. The format of 
the entries in the RSCS directory are described in the preceding section, 
"Planning to Install RSCS". The sample directory supplied on the distribution 
tape is shown in Figure 10. 


STEP 5. MODIFY THE SUPPLIED SAMPLE RSCS PROFILE 


You may use the CMS Editor to modify the supplied sample RSCS profile (PROFILE 
SAMPLE Cl) initial startup command file to automatically issue any sequence of 
RSCS commands at RSCS IPL time. 


Any valid RSCS command may be entered in the command sequence. A dash (=) as 
the first character of a command line in an RSCS automatic execution file 
suppresses the printing on the RSCS operator console of the DMTREX679I 
message, which includes the command line, as the command executes. This 
feature is to suppress printing of comment lines and password information 
supplied in the parameter fields of START commands included in automatic 
execution RSCS command sequences. 


The default PROFILE SAMPLE supplied on the RSCS distribution tape is: 


HEHE HEHEHE HE HEHEHE HEHE HE HE SE IE IESE IE DE SE IE IESE IE DE SEE ETE IE DE SESE SE IE ESE IE 3E SE DE DE DE IEE SE IE SE DE 3E SE IE ESE IE SE SESE DE SE IE IE HE IE 3E IE ETE IEE 
—x DEFAULT CP COMMAND SETTINGS * 
HEHE HEHEHE HEHE IE HE HEI IE IE IE IE IE IE HE HE IE IE HE IE IE IE IE HEHEHE IE HE HEHE IE IE FE IE IEE IEICE IE HE IE HE IE IE IE DE SE IE SE IEE IE IEE IE IE IE DE SE IE FE IEE EE IE 
CP SET IMSG OFF 

CP SET EMSG ON 

CP SPO CON START 


Note: Steps 4, 5, and 6 may be skipped if your RSCS system disk already has a 
directory and profile. 
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HH HH HH HHH HHH HHH HHH HH HHH HH HHH HH HH HHH HHH HH HHH HHH HHH HHH HHH HHH HHH HHH HMMM MHH 


* RSCS LOCAL NODE-ID SPECIFICATION * 
3E HE IE FE HE HEE FE IESE HE HE FE HE HE FE FE FE IE FE IE SE HE BE TE IE HE IE HE DE HE IE IE IE IE FE IE HE IE IE IE HEHEHE IESE HE IESE HE FEE IE IE HIE IE IE IE HEE IE IEEE IEE HH HEN 
x LOCAL GMT * 
* NODE-ID OFFSET * 
, * 
LOCAL HOME 5 
* NODE-ID NAME = HOME * 
* GMT OFFSET = 5 (EASTERN STANDARD TIME) % 
FE FE IEE HE FE IE IE HE HE IE IESE HE BE IE FE DE DE IE IE IE HE FE DE IE HE FE IE DE BE DE IE IE IE IE DE IE IESE SE DE IE IE DE IE IE IE 3 DE FE IE SE IE IE IESE HE IESE IE IE IEEE IEEE HEHE 
* RSCS LINK-ID SPECIFICATIONS * 
IE IE IE IE HE IE IE IE IE FE HE HE IE FE FETE FE FE HE BE IE HEHE HE HEHE HE HE HE IE FE IEE HEHE IE HE HE HE HEHE HE HEHE HE IE IE IE HE HE IE HE HEHEHE EI HH HEH HIE IH HHH HHH 
rd LINE VIRTUAL TIME TASK SPOOL KEEP * 
* LINK-ID DRIVER ADDRESS ZONE ID CLASS SLOTS x 
MH ee ee ee ——-— ee ee * 
LINK NPTTEST DMTNPT x% 5 NPT1 * 2 
LINK SMLTEST DMTSML 031 5 SYS1 A 2 
LINK NJITEST DMTNJI 082 & MVSA * 2 
LINK VMBTEST DMT VMB 0383 6 SYS2 * 2 
LINK VMCTEST DMT VMC 310 5 SYS3 * 2 
LINK POWTEST DMT POW 037 5 DOS1 D 2 
LINK RPTTEST DMTRPT 210 5 RPTT * 2 
IEE HEE HE IE BE IE HE IE HE HE SE HE HE HE HE BE FE IE HE IE HE HEHE HE HEHE HEE HE HEHE HEHE HE HEE HEHE HE HEE HE HE HE HE IE SE HEE HE HE HEE HE EE HEHEHE HEH HH MH HH 
* RSCS PARM SPECIFICATIONS * 
HE HE HEHE HE HE IE HEE IE HEHE FE HEHE TE FE IE HE IE DE IE HE IE IE IE IE IE IE IE HE IEE HE HE IE IE HE IE IE IE HE HEHE IEE EE FE HE IE IE HEHE HEHE IE HEHE IE HE HE EEE HE HE HEHEHE 
* LINK-ID PARM TEXT * 
Se a a a a ee ee a ee ee ee ee ee ee ee x* 
PARM SMLTEST MOl B400 
PARM POWTEST Cool 
36 36 3 3 IE IEE 3E ESE IE SESE 3K ESE SE IE SE DE DE BE IE BE IE IE DE DE DE IE IE IE DE DE DE DE DE FE SESE SESE SE 5 SE FE SESE 5H 3 SE IE DE SESE IE SE 3 HE IE DEDEDE SE EE HE HEE HEH 
x RSCS ROUTE SPECIFICATIONS * 
IE IE IE IE BE IE IE IE IE IE IE HE HE IE BE IE IE IE IE IE IE FE IE IE DE FE HE FE IE IE FE FE HE HE FE IE HEE HE IE FE IE IE FE HE DE FE HE IE BE FE EE DE HE HE DE HEHE HEHE HE HE HEHE HE HE HEHEHE 
* LOC-—ID LINK-ID COMMENTS x 
My a ee — RR RE Re ee eee eee eee ee eee * 
ROUTE ROUTTEST VMBTEST PASS FILES FOR ROUTTEST TO VMBTEST 
IE IE IE IE IE IE IE IEE FE HE HE IE HEE FE HE HEHE IE IE IE IE HE HEHE IEE IE FE IE HE IE IE IE FE FE HE HE HE IE IE IE IE HEHE HE HE IE HE HEHE HEHE HE HEHE HE HEHEHE HEHE HHH HH HHH 
* RSCS BISYNCH DIAL PORT DEFINITIONS x% 
HEHE IEE IE HEE HE TE HEHE DE HE IESE HEHE FE DE HE FE IE HEHE FE HEE SE HE IE SE HE IESE SE HE IEE HE IE HE DE HE IE IE IE IE HE IE HE IEE IE SE HE IE IE TEE FE HEE HEE HEE HE EEE HE 
* VIRTUAL x 
* ADDRESS x* 
* -----——— * 
PORT 0380 
3E HE HE HE IE IE IE FE FE FE IE SE FE SESE SE FE SESE 3K IE SE FE IE IE SE SE SE SE 3 SE 5E SE SE 5K 5E SE SESE SE 3 DE 3E IE SE IE SE SE SE FE IE SE SE DE 3E IE IE IE DE FE SE IESE FE 3K 5 IE HE IEEE 
* RSCS SUPERVISOR SPECIFICATIONS * 
HE HEE IE HEHE IE HE IE IE HE IE IE HE IE IE IE HE HE HEE HE HE IE IE HE IE IE HEHE FE HE HE HEHE HEHE HE IE HEHE TE IE IE HE HE EE HE HE HEHE HEHE HEHEHE HEHEHE HEHE HEHEHE HE HH HHH 
TAGS 384 NUMBER OF TAG SLOTS TO GENERATE 


HEHEHE HEHE HE HE HEHE HE HEH HE HE IE HE HE HEHE HEHE HEHE HEHE HHH HH HE HH HH HHH HEH HHH HHH KH HHH HHH HH HHH HHH HHKKHKKHKKKKN 


| Figure 10. Sample Supplied RSCS Directory 
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STEP 6. MOVE THE RSCS DIRECTORY AND PROFILE TO THE RSCS SYSTEM DISK 


After the necessary local modifications have been made to the sample directory 
and profile, copy them to the RSCS System Disk using the following commands: 


COPY SAMPLE DIRECT C RSCS = A 
COPY PROFILE SAMPLE C = RSCS A 


Note: This step also renames these files to the names required by RSCS. 


STEP 7. MAKE SURE STAGING DISKS ARE DEFINED 


Staging disks are minidisks used to keep the text and source code distributed 
by IBM. Separate staging disks are recommended for text, source code, and 
service updates. Typically the text of several IBM products are kept ona 
common text staging disk, the source of several IBM products are kept on a 
different common source staging disk, and the service updates for several IBM 
products are kept on still another’ service staging disk. 


It is recommended that the common text staging disk for RSCS be defined with a 
virtual disk address of 194, the common source staging disk disk be defined as 
394, and the common service staging area be defined as 294. If you choose 
other disk addresses, you must respond to the prompt from the RSCSBASE build 
EXEC with the appropriate disk address. 


The amount of additional DASD space recommended for the RSCS staging areas are 
Shown in the following table. Note that the service staging requirements may 
vary, depending on the amount of service activity. 


Base Text Base Source Service 
Staging Area Staging Area Staging Area 
(default 194) (default 394) (default 294) 


2314 6 Cylinders 61 Cylinders 3 Cylinders 


3330 3 Cylinders 32 Cylinders 2 Cylinders 
3340 9 Cylinders 89 Cylinders 4 Cylinders 
3350/3380 2 Cylinders 16 Cylinders 1 Cylinder 

3310/3370 1536 Blocks 13312 Blocks 1024 Blocks 


Note: Steps 4, 5, and 6 may be skipped if your RSCS system disk already has a 
directory and profile. 
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STEP 8&8. LOAD AND BUILD THE RSCS SYSTEM 


If everything has been set up as recommended, you may now issue the EXEC 
provided for loading the RSCS product, building the RSCS system disk, and 
creating an IPL-able RSCS nucleus by issuing the following: 


RSCSBASE NORESP 


Note: If you received a service tape, issue instead: 


RSCSBASE NORESP SERVICE 


see the description of the RSCSBASE EXEC on page 2-21 for the effect of adding 
the SERVICE option. 


The RSCSBASE EXEC, as specified, will do the following: 

e Access the source staging disk (394) as the A-disk. 

e Access the text staging disk (194) as the B—-disk. 

e Load the Base RSCS text and source to their respective disks. 

e Access the RSCS System Disk (195) as the A-disk. 

e Copy the RSCS line drivers and supervisor tables to the RSCS System Disk. 

e Build and IPL the RSCS nucleus. 

The installation EXEC will type informational messages on the console to tell 
you how it is progressing. You will see the following messages (among others) 


on your console: 


LOADING FILE 2 (RSCSNET TEXT) ... 


LOADING FILE 6 (RSCSNET MACRO SOURCE) ... 
COPYING RSCSNET DISK RESIDENT TEXT ... 


DMSCPY721I COPY *"DMTAXS TEXT B1l* TO "'DMTAXS TEXT Al* (NEW FILE). 


eo 


DMSCPY721I COPY "*DMTRPT TEXT B1* TO *DMTRPT TEXT Al* CNEW FILE). 
PUNCHING RSCSNET NUCLEUS ... 

SYSTEM LOAD DECK COMPLETE 

PUN FILE 4904 TO MAINT COPY 001 NOHOLD 


IPL'ING OOC ... 
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(WHEN THE NEW RSCSNET SYSTEM IS BUILT, ISSUE THE FOLLOWING COMMAND 
TO PRINT THE LOAD MAP) 


| "CLOSE PRT? 


If your virtual console address is not X'009", you must generate an attention 
interrupt (for example, press ENTER on a 3277). 


| You Will then receive (and must respond to) the following messages. 
(Responses are shown to the right of the messages.) 


DMTINIG11R SYSTEM DISK ADDRESS = 195 
Note: 195 is the address of the RSCS system disk in this example; 


it is the same number that you specified in the FORMAT 
command in Step 3. 


DMTINIG12R REWRITE THE NUCLEUS ? yes 
DMTINIG13R NUCLEUS CYL/BLK ADDRESS = nnnan 
Note: nnnn = 004 for a 2314 

002 for a 3330 

006 for a 3340 

001 for a 3350 or 3380 


1024 for a 3310 or 3370 


After a brief pause, you Will have written an IPL-able RSCS nucleus to the 
RSCS system disk, as indicated by the message: 


DMTINI410I NUCLEUS WRITE COMPLETE 
CP ENTERED; DISABLED WAIT PSW '00020000 00000012" 


You may now LOGON the RSCS virtual machine, IPL the RSCS system disk, and 
start your RSCS operations. 


THE RSCSBASE EXEC 


The installation EXEC has options that will allow you to alter the 
installation procedure described above. The options of this EXEC are designed 
specifically to have the same name as and to perform the same function as the 
options defined in the VMSERV EXEC used in the VM/370 Program Update Tape 
(PUT) process. One new option, SERVICE, has been added which is not applicable 
to VMSERV. 


| The command format is: 


| RSCSBASE [NOIPL EXIT BUILD] [NORESP] [SERVICE] 
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where: 


NOIPL 
EXIT 
BUILD 


NORESP 


SERVICE 


causes the installation procedure to stop just before IPLing the 
RSCS nucleus. The nucleus has been built and has been punched to 
the reader (00C). 


causes the installation procedure to stop after the tape has been 
loaded but before the new RSCSNET system disk has been built. The 
RSCSNET system disk is not required when this option is chosen. 


causes the RSCSNET system disk to be built. This includes copying 
the line driver and supervisor tasks, and creating and IPLing the 
RSCS nucleus. No tapes are used when this option is chosen. 


turns off the prompting of the user for the DASD device addresses of 
the RSCS staging areas and system disk. The following default 
staging area addresses will be used: 

195 for RSCSNET System Disk 

194 for RSCSNET Text Staging Area 

29% for RSCSNET Service Staging Area (if SERVICE specified) 

394 for RSCSNET Source Staging Area 


indicates that an RSCS service tape is to be installed along with 

the base tape. This EXEC will stop to allow the user to mount the 
service tape. The service EXEC on the service tape will be called 
to load the service. The other options entered on the RSCSBASE EXEC 


will be passed to the service EXEC. An RSCSNET service staging area 


is required when this option is specified. 


| Usage Notes: 


| 1. The 


2. The 
inst 
% HH 
HHH 
HHH 


HHH 
KEK 
HHH 
HR 
HER 


RSCSBASE EXEC and the service EXEC must run from the C-disk. 


following self-explanatory messages may be issued during the 
allation procedure: 

ERROR READING INSTALL TAPE OR WRITING TO DISK ‘Cuul xxx 
ERROR READING SERVICE TAPE OR WRITING TO DISK ‘*cuu’ xxx 
FILE NOT FOUND ON SERVICE TAPE ~ PLEASE INSURE THAT 

THE CORRECT TAPE IS MOUNTED xxx 

ERROR CREATING THE RSCSNET NUCLEUS x3¢3 

ERROR ACCESSING DISK ‘cuu’ xxx 

ERROR COPYING RSCSNET DISK RESIDENT TEXT xxx 

OPTION CONFLICT EXISTS, PLEASE RE-ENTER 3x 

INVALID OPTION, PLEASE RE-ENTER 36% _ 


3. Return codes used by the RSCSBASE EXEC are: 


| 4. The 


0 —- Normal exit 

G&G —~- Exit requested by user 

8 - Error: invalid or conflicting options 

16 — Error: unable to access required disk(s), 
unable to read tape, etc. 


following shows the effect of specifying [NOIPL|EXIT|BUILD] to the 
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Load All Files YES YES NO YES 
Copy Text 

Punch Nucleus 
IPL the Nucleus 


5. Since IPL-ing the RSCS nucleus takes your virtual machine out of the CMS 


environment, the NOIPL option is provided to bypass this IPL. The EXEC 


Will spool your reader class I before punching the nucleus. When you are 
ready to IPL the RSCS machine, spool your reader class I and IPL OOC Cyour 
virtual reader). You will have to close your virtual printer (CLOSE O0E) 


to get the load map to print. 


6. You can override the default DASD disk addresses used by not entering the 


NORESP option. You will then receive the following instructions and 
prompts: 


YOU WILL BE REQUIRED TO REPLY TO QUESTIONS REGARDING THE INSTALLATION 
OF RSCS NETWORKING. THE ACCEPTABLE RESPONSES WILL BE SHOWN IN PAREN— 
THESES. A RESPONSE SHOWN WITHIN DASHES, E.G. —-195-, IS THE DEFAULT, 
AND MAY BE SELECTED WITH A NULL RESPONSE. 


REMINDER: THE MINIDISKS USED FOR THE RSCS NETWORKING PROGRAM PRODUCT 
SHOULD BE DIFFERENT FROM THE MINIDISKS USED BY THE RSCS 
COMPONENT OF VM/370 IF YOU WISH TO KEEP BOTH PRODUCTS. 


ENTER RSCSNET BASE TEXT STAGING AREA ADDR (—194- | CUU) 
ENTER RSCSNET BASE SOURCE STAGING AREA ADDR (-394~ | CUU) 
ENTER RSCSNET SYSTEM DISK ADDRESS (~195-— | CUU) 

ENTER RSCSNET SERVICE STAGING AREA ADDR (—294-— | CUU) 


7. Use the SERVICE option when you have a service tape to install at the same 


time as the base tape. The RSCSBASE EXEC will stop when it iS ready to 
apply the service and give you the following prompt: 


IT IS ASSUMED THAT THE SERVICE TAPE IS READY ON 181; 
REPLY (—GO— EXIT) 


When the tape is ready, reply GO (or null) and the installation will 
proceed. If you do not wish to continue, reply EXIT and the installation 
Will stop. At this point, your system is in the same status as if you 


originally entered the EXIT option (without the SERVICE option). 


If you continue, the first two files of the service tape will be loaded 
onto the C disk (MAINT’s 191 disk) and you will see the following prompt: 


DO YOU WISH TO HAVE THE MEMO TO USERS PRINTED? (-YES- | NO) 


You will be told when the SERVICE EXEC is entered and exited by the 
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following: 


NOW ENTERING SERVICE EXEC ... 
SERVICE EXEC ENDED WITH RC= n 


While in the service EXEC you will receive the following information 
messages when the contents of the service tape is being loaded: 


LOADING FILE 3 (RSCSNET REPLACEMENT TEXT) ... 


LOADING FILE 10 (RSCSNET NEW OR UPDATED SERVICE TOOLS?) ... 


Note: Files 6 through 10 may be null files if there is no service activity in 
these areas. 


UPDATING RSCS 


Use standard VM/370 updating procedures to update RSCS. You can invoke VMFASM 
to assemble any RSCS source module using the supplied RSCS control file. Use 
loadlist DMTLOAD and the VMFLOAD program when regenerating the RSCS nucleus. 


The DMTNJI line driver is a multi-module line driver distributed with RSCS. 
Use the RSCS preloader to construct DMTNJI TEXT from its component modules via 
the command: 


PRELOAD DMTNJI RSCS 


Where DMTNJI specifies an IBM—supplied EXEC file loadlist and RSCS specifies 
the IBM-supplied CNTRL control file to be used. 


The spool access manager DMTAXS is also a multi-module task. Use the RSCS 
preloader to construct DMTAXS TEXT from its component modules via the command: 


PRELOAD DMTAXS RSCS 


Where DMTAXS specifies an IBM—supplied EXEC file loadlist and RSCS specifies 
the IBM-supplied CNTRL control file to be used. 


Note: All PRELOAD input files must be located on the user's A-Disk or 
read-only extension. 


THE RSCS PRELOADER 


The preloader (part of RSCS Networking) is a utility program that runs under 
CMS. It collects text files and reformats them into a single text file that 
can be dynamically loaded by the RSCS loader. It resolves external references 
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and performs preliminary relocation of address constants. Its function is 
Similar to that of a linkage editor, but its output is in standard text file 
format and does not include multiple CSECTs. 


Line drivers and other programs to be loaded as RSCS tasks may be developed as 
multiple separate assembly modules which externally reference one another; the 
assembled text files may be merged into a single RSCS loadable text file by 
the preloader under CMS. The preloader is invoked as an ordinary CMS utility 
routine: 


PRELOAD loadlist [control] 


7loadlist’ specifies the filename of an EXEC file which must reside on the 
Caller’s A-disk. Each record of this file contains the filename, and optional 
filetype, of a text (object) file to be used as preloader input. ‘control’ 
specifies the filename of a CNTRL file Which must also reside on the caller's 
A-disk if it 1s specified. The format and interpretation of this file are the 
same as for the VM/370 VMFLOAD utility. If a load list entry includes a 
filetype, that filetype is used to identify the input file. Otherwise, if a 
control file is specified, input file identifiers are constructed using the 
filename from the load list entry anda filetype of the form "TXT....* The 
highest control level identifier for which a file can be located on the 
caller’s accessed disks 1s used. If no filetype is included in a load list 
entry and no control file is specified, a default filetype of TEXT is used. 
Input files are located by a scan of all the caller's disks in their access 
order. 


Note: PRELOAD is not to be used to generate the RSCS nucleus. 


The preloader output consists of two files, one with a filetype of TEXT, the 
other of filetype MAP, both with the same filename as that specified for the 
input load list. If either of these files already exists on the caller's 
A-disk, the old file is replaced by the new output file. 


The output TEXT file is the merged and linked copy of the input files. The 
first CSECT or private code section in the input becomes the composite 
(single) output section; its length is the sum of all input section lengths 
(rounded up to doubleword multiples between sections for proper section 
alignment). For the output ESD, subsequent CSECTs are made into entries 
(RLDs), and subsequent private code sections are disregarded. External 
references are included in the output ESD only if they remain unresolved. 


Input TXT records of non=zero length are relocated and written to the output 
file. The output RLD is a translated and relocated collection of all input 
RLD records. The output END card does not specify any entry point, section 
length, or other code. No sorting is done by the preloader. In general, each 
output ESD, TXT, and RLD entry appears in the same order as the input entry 
from which it was translated. 


ADCON and VCON fields are relocated within their TXT records. ORG statements 
that cause relocatable constant fields to overlay or to be overlaid may cause 
results that differ from results obtained with a loader that completes TXT 
data loading prior to relocating ADCONs and VCONs. 


Installing RSCS 2-25 


The output MAP file is a printable record of the preloader processing, similar 
to a load map. The first line of the map specifies the output text file name, 2 
its residence volume label and virtual device address, and the date and time | 

of file creation. The next section of the map is a listing of the control 
file used, if one was specified. The remainder of the map consists of a 
sequence of input file sections, one for each input file in processing order. 


The first line of a map input section specifies the input file’s filename, 
filetype, and filemode; residence volume label and virtual device address; and 
the file creation date and time. If the input file data contains invalid 
records, the preloader writes them in the map sequentially following the input 
file identification line. The VM/370 VMFASM utility enters such "invalid™ 
records in text files to specify the updates and macro libraries used in 
assembly. Following these records, the input file’s ESD is listed, including 
control sections and entries with their relocated addresses, duplicate 
external symbols, and unresolved external references, if any. The first 
control section in the input specifies the output control section name; the 
output section length is included on this ESD map entry. 


The preloader does not actually load its input modules into storage before 
generating its output section, but rather interprets, translates, and 
relocates itsS input text files on a two-pass record by record basis. This 
approach requires that for each TXT record of a particular input control 
section, each RLD entry (one for each ADCON and VCON) which lies within that 
control section must be scanned to determine if it lies within the TXT record 
data. As a result, the preloader processing time has a component that 1s 
proportional to both the total number of TXT records and the total number of > 
RLD entries for each input control section. Roughly stated, this means that 
when a particular input control section grows sufficiently large, the time 
required to process it becomes proportional, not to the input control section 
size, but to the square of that size. This effect is significant when a large 
text file previously generated by the preloader is used as preloader input. 

In this case, much more CPU time may be required to reprocess the preloader 
output than was required to generate it in the first place, because several 
smaller control sections have been merged into a single large control section. 
This kind of program behavior can be expected, and does not indicate a 
malfunction. 
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Part 3 describes the operation of RSCS. 
The main areas included are: 


e A general description of the 
operation of RSCS. 


e A description of the specific 
procedures to operate RSCS. 


Part 3: 


Part 3: RSCS Operation 
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Operation Description 


RSCS OPERATOR COMMANDS 


The RSCS operator controls the local RSCS facility; the operator can: 


e Alter the status, transmission priority, class, and order of files owned by 
the RSCS virtual machine. 


e Start, suspend, or stop transmission of files to remote terminals and 
stations. 


e Reposition or restart files being transmitted. 


e Send messages to remote terminals, stations, and other nodes in the 
network. 


¢ Send commands to remote batch processing systems. 
e Query file, link, or system information. 
¢ Monitor link activity for any directly connected remote location. } 


File attributes and the parameters describing them in the RSCS command 
language have maximum and default values identical to those of the VM/370 
command language. Because many RSCS operator commands are available to remote 
station operators, only brief descriptions of the commands that apply to the 
RSCS virtual machine are included in this section. The commands are grouped 
in a general chronological sequence as an operator would use them. A complete 
description of all commands, With detailed format, is in "Appendix A: RSCS 
Commands". 


Commands available to the RSCS operator fall into four general 


Classifications: link and line control, file control, communication, and 
miscellaneous. 


LINK AND LINE CONTROL COMMANDS 


The RSCS operator commands to manage the links and lines used for file 
transmission are: 


DEFINE FORCE ROUTE 
DELETE FREE SHUTDOWN 
DRAIN HOLD START 
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Use DEFINE to temporarily add a new link entry to the list of valid links 
Clink table) for the local RSCS installation, or to temporarily redefine an 
existing link definition. (Permanent link definitions or redefinitions can 
only be made by modifying the RSCS Directory.) A link definition, with a link 
identifier equal to the location identifier of a remote station, must exist in 
the RSCS link table before any transmission of files, to or from that remote 
station, can occur. 


DELETE 


Use DELETE to temporarily delete a link definition from the RSCS link table. 
(Permanent link deletions can only be made by deletion from the RSCS 
Directory.) The link to be deleted must be inactive (drained or not started), 
and must have no unprocessed files addressed to it. Files later addressed to 
a deleted or undefined link are purged from the system. 


Use DRAIN to deactivate an active link. If the link is currently processing a 
file, the link is deactivated When the current file has completed processing. 
If no file is being processed, the link is deactivated immediately. 


Use FORCE if the DRAIN command fails to deactivate a link. FORCE immediately 
deactivates the specified link and terminates its line driver task regardless 
of the status of file processing. 


Use HOLD to temporarily suspend file transmission on an active link without 
deactivating it. Transmission is suspended at the end of the file currently 


Operation Description 3-3 


being processed unless a keyword is entered signifying that transmission is to 
be halted immediately. In either case, transmission is restarted at the 
interrupted point when FREE is issued. 


ROUTE 


Use ROUTE to define, modify, or delete an entry in the RSCS routing table. 
Files are automatically reenqueued following execution of a ROUTE command, so 
that transmission of rerouted files can begin immediately. 


SHUTDOWN 


Use SHUTDOWN to terminate RSCS operation normally. SHUTDOWN effectively 
issues a DRAIN command to each currently active link. 


Use START to activate an inactive link. Certain keyword options may also be 
entered to temporarily override the link definition in the link table. This 
command may be issued to an active link but solely for the purpose of altering 
the class of files to be processed on that link or to reset a DRAIN operation 
before it has completed. 


FILE CONTROL COMMANDS 


Files sent to the RSCS virtual machine for transmission are put into the file 
queue assigned to the particular link to which the file is addressed. Files 
waiting in a queue to be transmitted are called inactive files; those being 
transmitted are called active files. The RSCS operator uses different 
commands for each kind of file: 


For Inactive Files For Active Files 


CHANGE ORDER BACKSPAC CLOSE 


PURGE REORDER FLUSH FWDSPACE 
TRANSFER 
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Use CHANGE to alter one or more attributes of a file owned by the RSCS virtual 
machine, enqueued on some link’s file queue, and not currently active. 


Use ORDER to reorder the files enqueued on a link's file queue. This 
redefines the sequence in which particular files are processed. An active 
file cannot be reordered. 


REORDER 


Use REORDER to cause all inactive files controlled by RSCS to be reaccepted 
and routed. REORDER is normally not used by the operator but by RSCS during 
internal operations. See command descriptions for details of REORDER usage. 


TRANSFER 


Use TRANSFER to redirect specified inactive files enqueued on a link to a new 
destination. This causes RSCS to dequeue them from the specified link and 
enqueue them on the link associated with the new destination. 


PURGE 


Use PURGE to remove all or specified files, enqueued on a link, from the 
system before being processed. An active file cannot be purged. 


FLUSH 


Use FLUSH to discontinue processing the current file on a specified link. The 
discontinued file is either purged or held and link processing continues with 
the next file enqueued for transmission on that link. If the COPY attribute 
for the file specified multiple copies, only that current copy is discontinued 
unless the discontinuance of all copies for the file is also specified. 
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Use CLOSE to clear the files if a link unexpectedly becomes inactive while 
processing active files. Active input files are reenqueued as inactive and 
later retransmission begins at the start of each input file. Active output 
files are purged. 


BACKSPAC 


Use BACKSPAC to restart or reposition, in a backward direction, the file 
currently being processed on the specified link. 


FWDSPACE 


Use FWDSPACE to reposition, in a forward direction, the file currently being 
processed on the specified link. 


COMMUNICATION COMMANDS © ) 


The RSCS operator can communicate with a remote station via the CMD or MSG 
commands. CMD is for sending a command to a remote system. MSG is for 
sending a message to a remote operator or user. 


CMD 


Use CMD to control functions performed by a remote system such as a HASP or 
ASP type batch processor, a remote RSCS, a remote VSE/POWER system, or a 
remote NJI-compatible system. 


RSCS does not process the command text; RSCS tramsmits the text to the remote 
system specified (except for VSE/POWER commands). The functional meaning of 
the command text depends on the nature of the remote system that receives the 
command. For example, if the remote system is a HASP or ASP type processor, 
the command text would be: 


§ Hasp command 


* Asp command J 
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For information on the allowable commands, refer to the appropriate manuals 
listed in the Preface. 


CMD is also available to the virtual machine user via the CP SMSG command; 
refer to "Part 4: VM/370 User’s Guide™ for details. 


MSG 


Use MSG to send a message (as opposed to a command) to a remote station 
operator, remote RSCS operator, remote NJI system operator, remote VSE/POWER 
operator or remote virtual machine user. The text portion is made available 
to the line driver for the specified link. MSG is also available to the 
virtual machine user via the CP SMSG command; refer to "Part 4: VM/370 User's 
Guide” for details. 


MISCELLANEOUS COMMANDS 


Other commands are available to the RSCS system programmer and operator to 
monitor and control the local network. They are: 


* (comment) EXEC 
CP HT 

CPQUERY QUERY 
DISCONN TRACE 


* (comment) 


Use the * command to place comments or notations on the RSCS operator’s 
console listing. It 1s accepted by the command processor but performs no 
function. 


Use CP to pass any permitted commands to the VM/370 Control Program without 
leaving the RSCS environment. 
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CP QUERY | 


Use CPQUERY only in a CMD command to request remote CP status information to 
be printed on the RSCS operator’s console. The operator can request the 
following: 
Indications of processor usage and contention 
Indications of main storage usage and contention 
Log messages of the day 
Userid and real address of each user logged on 
The current real clock time: 
Time of day 
Time zone 
Day of week 
Calendar day 
Connect time of the RSCS virtual machine 
Number of users logged on 
Number of users logically connected to other virtual machines 
Userid and terminal address of a specified user 


CPQUERY is also available to the virtual machine user via the CP SMSG command. 
Refer to "Part 4: VM/370 User’s Guide™ for details. 


DISCONN 


Use DISCONN to disconnect the RSCS operator's console from the VM/370 system 
while RSCS continues to operate. An optional userid may be entered in the 
command line to specify the virtual machine to receive all RSCS operator 
console output lines. If no virtual machine is specified, the RSCS console 
output lines are discarded without being printed. 


Use EXEC to execute frequently used sequences of RSCS commands. The commands 
are stored in a CMS file on the RSCS system disk with a file type of RSCS. 


Use HT to suppress the printing of any unwanted messages stacked for output to 
the RSCS operator's console. 
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QUERY 


Use QUERY to request RSCS status information to be printed on the RSCS 
operator's console or remote station printer. The information requested can 
be for a particular link, a specific file, or for RSCS in general. 


QUERY is also available to the virtual machine user via the CP SMSG command. 
Refer to Part : VM/370 User's Guide™ for details. 


LINK INFORMATION: For a particular link, the operator can request status, 
activity, default, file, or queue information. 


Status information includes activity status, type of line driver, line 
address, classes of files to be processed, HOLD status, DRAIN status, TRACE 
status, number of files in queue and number of files waiting to be queued. 


Activity information includes the VM/370 spool file ID, originating VM/370 
spool file ID, destination location and user ID, spool file class, file 
transmission priority, number of file records left to transmit, and total 
records, of the file currently being transmitted. 


Default information includes task name, type of line driver, line address, 
classes of files to be processed, time zone identifying digit, and number of 
virtual storage file tag slots reserved for the link. 


File information includes the number of files being transmitted, the number of 
files being received, the number of files accepted and in the queue, and the 
number of files pending. 


Queue information includes the number of files in the queue and the number 
Waiting to be entered in queue. In addition, for each file currently in the 
queue, an additional response is issued containing the spool file 
identification number, origin location, destination location, destination user 
ID Cif any), Spool file class, current transmission priority, the number of 
records in the file, and the file hold status. 


FILE INFORMATION: For a specific file, the operator can request status 
information, RSCS—-related file attributes, or VM/370 spool-related attributes. 


Status information includes activity status and the linkid of the link on 
which the file is queued or being transmitted. 


RSCS-related attributes include originating location and user ID, originating 
VM/370 spool ID, date and time of creation, time zone reference for time of 
day, and the destination location and user ID. 


VM/370 spool-related attributes include transmission priority, spool file 
class, number of copies requested, HOLD status, distribution code, filename 
and filetype, or data set name. 


SYSTEM INFORMATION: The RSCS operator can request a brief description of each 


inactive link, active link, port, non~zero queue, or route currently defined 
in the system. 
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Inactive link information includes link identification, activity status, 
default line driver type, and default line address. 


Active link information includes link identification, link status, line driver 
type, line address, and hold status, drain status, and trace status. 


Port information includes port availability status and identification of ports 
in use by link ID and port address. 


Queue information includes the number of files being transmitted and received, 
the files accepted and enqueued, and the files pending for each link ID with a 
non-zero queue. 


Route descriptions show the link ID for each route definition in the RSCS 
routing table. 


TRACE 


Use TRACE to monitor line activity on a specified link. The trace information 
message includes the total number of communication line transactions 
(write/read combinations), the number of communication line transactions 
ending With a line error indication, and the number of timeouts that occurred 
on the line. 


The line activity indicators are constantly accumulated by an active line 
driver, but printing of the results on the RSCS operator's console is 
initiated only through the TRACE command. The TRACE command with the LOG 
operand results in the creation of a printer spool file containing a detailed 
log of every 1/0 transaction on a link. 


RSCS MESSAGES 


RSCS issues messages in response to commands, and during execution. The 
response message is delivered to the associated command originator, generally 
the RSCS local or remote operator, or both, depending on the availability of 
the remote station printer to serve as an operator console output medium. 

When RSCS is operating in disconnected mode, it issues unsolicited messages to 
another virtual machine console or to the VM/370 operator's console by means 
of the VM/370 MESSAGE command, if specified in the DISCONN command. Console 
spooling can also be used to record messages issued to the RSCS operator's 
console when the RSCS virtual machine is operating in disconnected mode. If 
these options are not taken, these messages are discarded. 


Certain unsolicited messages are issued to virtual machine users via the 
VM/370 MESSAGE command when the message pertains to a file originated by or 


destined for the user. 


For a detailed listing and description of all RSCS messages, see "Appendix B: 
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RSCS Messages”. 


RSCS message codes conform to VM/370 standards. The first three characters in 
all RSCS message codes are "DMT". The origin of each message is encoded as 
the fourth, fifth, and sixth characters of each message code; the possible 
codes are REX, CMX, CMY, AXM, INI, RGX, IRX, NPT, RPT, SML, POW, VMB, VMC, 
NCM, NHD, and NIT. The seventh, eighth, and ninth characters are the message 
number. The tenth character is the message severity code; the possible codes 
are R (response), I (information), E Cerror), S (severe error), and T 
(termination of RSCS processing). Printing of the ten-character message codes 
may be suppressed by the local and remote RSCS operator by use of the CP SET 
EMSG TEXT command. 


RSCS uses the Diagnose function of CP to handle console functions such as 
DEFINE and DETACH. Use of these VM/370 commands by RSCS results in two 
confirming messages being printed on the operator's console for each file 
processed by RSCS. The RSCS operator can issue the CP command SET IMSG OFF to 
suppress these informational messages. 


If an unrecoverable error occurs, RSCS enters a disabled wait state. If 
either the DMTREXO90T or DMTREX091T message is displayed on the RSCS 
operator's console, an automatic virtual storage dump is also taken. 
Otherwise, the CP DUMP command should be issued. 


COMMUNICATING WITH JES2/NJE SYSTEMS 


RSCS supports a subset of the full NJI protocol defined by the Network Job 
Entry Facility for JES2. For details of the full NJI protocol refer to Logic: 


Network Job Entry For JES2, LY24-6001. The following points must be 


considered when communicating With a JES2/NJE system: 


e The DMTNJI line driver supports the predefined connection protocol used by 
JES2/NJE. Therefore, any connection between RSCS and JES2/NJE must be 
predefined by the JES2 system using a CONNECT statement in the JES2 
initialization deck. Failing to include the CONNECT statement produces 
unpredictable results at link connection time. Additional CONNECT 
statements must be added to the JES2 initialization deck for any locations 
receiving files from JES2 through the predefined RSCS connection. 


e¢ The DMTNJI line driver uses a single transmission stream (either job or 
output) to a remote system. It supports the simultaneous reception of one 
job stream and one output stream. 


e When a data set with multiple destinations is received by DMTNJI, the data 
set is stored and forwarded by RSCS as separate files. When a job output 
file containing data sets with different attributes is processed by RSCS 
(such as an output file containing both print and punch data sets), it is 
stored and forwarded as separate files. 


e NJE global commands not destined for the local node are stored and 
forwarded to the final destination system in the normal manner. Global 
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commands directed to the local RSCS system by DMTNJI are translated into 
the appropriate RSCS commands. If the final transmission link to the local 
RSCS system is not through the DMTNJI line driver, Global commands are not 
processed by RSCS. 


e When a data set containing ASA control characters is received by DMTNJI, 
the control characters are converted to machine control characters before 
being placed in the CP spool system. Upon any subsequent retransmission to 
another node, the characters are sent as machine control. 


ID CARD FORMAT FROM REMOTE STATIONS 


ae Oo EE ee 06 RINE 


The ID card is entered at the beginning of a deck of cards from a remote 
terminal to specify the network destination of the file being entered. The 
format of a single—parameter ID card is: 


ID userid 


l 10 


userid specifies the destination user at the directly connected RSCS location 
to which the file following the ID card is addressed. 


The format of a two-parameter ID card is: 
ID locid userid 
1 10 


locid and userid specify the destination location and user address to which 
the file following the ID card is addressed. userid may be replaced by the 
keyword SYSTEM if the file is to be produced as real unit record output at the 
destination location, and by the keyword JOB if the file is to be entered as a 
job at the destination batch processing system via the Network Job Interface 
(NJI)D. 


ES ET CT OS Ce ES 


Files or jobs may be submitted through the VM/370 real card reader to RSCS for 
transmission. The data deck to be transmitted must be preceded by an ID card 
to direct it to the RSCS virtual machine and a *tagtext’ card to specify 
destination. The formats of these cards are: 
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r 1 
ID userid CLASS n < filename filetype > 


dsname 


ID 15 a mandatory keyword. 

userid specifies the name of the RSCS virtual machine. 

CLASS is an optional keyword. 

n specifies the file class. The options are A-2Z and 0-9. 


The default is A. 


filename specifies the label on the input data. 
dsname 
filetype specifies the type of file if filename is used. 


The punching must start in card column one and each field must be separated by 
a blank column. 


The second card contains the tagtext portion of the TAG command used when 
submitting a file from a virtual machine user console. 


Punching starts in card column one and all fields are separated by a blank 
column. A sample job file submitted through the real card reader to RSCS for 
transmission to the node HOUSTON is: 


ID RSCS First card (ID card) 
HOUSTON JOB Second card (tagtext card) 
11KKXxXKKXKKKX Job file to be transmitted 
11 XXXXXXXXXX to HOUSTON by RSCS. 
11xxX<xxxXx**KX 
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Operation Procedures 


SYSTEM START-UP 


Normally starting RSCS requires no operator action after the RSCS virtual 
machine IPL. The route and link tables are created during the system 
Initialization from the RSCS directory on the RSCS system disk. The line 
drivers are normally started by the automatic execution of the PROFILE RSCS 
file. (All required START commands for the line drivers are placed in the 
PROFILE RSCS file by the system programmer at system generation time.) 


Additional line drivers may be started individually, if required, by using the 
START command formats shown in the following descriptions of starting the 
various line driver types. 


Any temporary changes desired in the link and route definitions can be made 
using the commands described under "Dynamic Reconfiguration”. 


SYSTEM SHUT-DOWN 


Operation of the RSCS virtual machine is terminated when the RSCS operator 
1ssues the SHUTDOWN command. This effectively issues a DRAIN command to each 
active link. Any link that is currently processing a file Will complete that 
file and then deactivate. A link that is not processing a file deactivates 
immediately. When all links have reported successful deactivation, the RSCS 
operator may logoff his RSCS virtual machine. 


Any files waiting for transmission at the time of system shutdown will be 
retained by the VM/370 spooling facility. These files will be reaccepted and 
enqueued to the appropriate links when the RSCS virtual machine is started 
again. 


STARTING LINE DRIVERS 


Line drivers manage the transmission of files between the RSCS virtual machine 
and a particular class of remote nodes, terminals, or stations. Seven line 
drivers are supplied with RSCS designated as DMTSML, DMTPOW, DMTNPT, DMTRPT, 
DMTVMB, DMTVMC, and DMTNJI. See the section on "Line Drivers™ in "Part 1: 
Introduction” for a detailed description of the function of each line driver. 


The RSCS operator initiates a line driver for a particular link by issuing the 
START command. If the previously defined link definition is still valid, only 
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START linkid 


need be specified. If any of the link attributes must be changed for this 
communication session, the START command With appropriate operands is used. 
For example, if the link to HOUSTON had been defined with a line address of 
OB1 and a class of G, and the current session is to handle class S$ output on 
line address 0B3, the START command would be: 


START HOUSTON CLASS S LINE OB3 


For this session only, the HOUSTON link processes only class S output and uses 
the line port with virtual address O0B3. Output other than class S remains 
queued on Houston’s link and is not transmitted until the class attribute is 
changed. 


Since more than one link can require the same line driver, multiple copies of 
a line driver can be active simultaneously. Each copy is assigned a task name 
When the link i585 defined; otherwise, a default task name is generated by RSCS 
When the link is activated. 


After the line driver is activated during system start-up or by the RSCS 
operator, the link for a leased line is ready for a remote station to "sign 
on” with its identification and station characteristics. A link using a 
switched line must first complete a line connection by a dial-up procedure 
from either end of the link. The sign-on procedure varies by line driver and 
is covered in the following line driver discussions. 


STARTING AN SML LINE DRIVER (DMTSML) 


Before a remote station can sign on to SML, the appropriate task for that link 
must have been started during system start-up or by the RSCS operator. The 
START command for SML and the variables to be specified are: 


linkid [TYPE DMTSML] [LINE vaddr] 


Hrn 
Rrn 


Parm < Arn > [Bnnnn] |password 
| Mrn | user/pwd 


linkid is the location identifier of the remote station. 

DMTSML is the name of the line driver to be used. This specification 
overrides the driver name which may have been previously defined for 
the link. If no driver was previously defined for the link, this 


field must be specified. 


vaddr is the virtual address of the communications line port. (vaddr is 
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used only if the line port is to be other than one previously 


specified in a link definition.) ; 
Parm is a keyword signifying that one or more parameters follow. 
Hrn sets SML mode, indicating that SML operates as a remote job entry 


system into a remote HASP or JES2 system as remote number rn. 


Rrn sets SML mode, indicating that SML operates as a remote job entry 
station into the Remote Entry Subsystem (RES) of OS/VS1 as remote 
number rn. 


Arn sets SML mode, indicating that SML operates as a remote job entry 
system into a remote ASP or JES3 system as remote name rn. 


Mrn sets SML mode, indicating that SML operates as host to a remote 
programmable station signing on as remote number rn. 


Bnnnn indicates the telecommunication buffer size. The maximum value of 
nnnn is 1017. If the operand is omitted, the buffer size defaults 
to 400. If the optional password operand is specified, the buffer 
size must be entered. 


password 1S an:optional operand, used by the DMTSML line driver to 
user/pwnd validate the start of a terminal session as follows: 


e In RJE mode, the specified identification is passed along to the 2 
remote system as part of the SIGNON record. 


If the remote system is HASP, ASP, or JES, the identification 
consists of a one— to eight-—character line password. 


If the remote system is RES, the identification consists of a 
one— to eight-—character userid followed by a slash character 
followed by a one—- to eight=-character password for a maximum of 
17 characters. 


¢ In HOST mode, the identification consists of a one— to 
eight-—character password that the remote station must Supply on 
its SIGNON card in order to connect to RSCS. If no password is 
entered on the START command, none iS required from the remote 
station. 


For a general description of the START command, refer to "Appendix A: RSCS 
Commands”. 


If the operator has initialized the appropriate SML task, contact may be 
established by dialing the other location from either end of the link. If the 
line specified is a leased line, or if the above contact procedure has been 
successfully accomplished, the sign-on procedure is then executed. 
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Signing On in RJE Mode 


If SML is operating in RJE mode, the SML task Signs on to the remote HASP/ASP 
system. Using information from the START command and standard HASP/ASP 
protocol, SML builds a SIGNON record and submits it to the remote system. 
When the remote system accepts the SIGNON record, SML is notified and 
communication on the link is initiated. 


If SML is operating in HOST mode, the remote station must submit the sign-on 
information. Because remote programmable stations are loaded with Remote 
Terminal Processor (RTP) programs to communicate with RSCS, the SML SIGNON 
card or its equivalent is included in the program deck. A password for system 
security may also be included. The format of the SIGNON card is: 


1 16 25 


/*SIGNON REMOTErn password 


The value of rn following the keyword REMOTE must match the terminal number 
specified in the Mrn operand of the START command. 


A password is required only if the START command specified a password operand, 
or if a password was part of the link definition in the RSCS link table. If 
the password option is in effect, the password entered must match that in the 
START command or link table for the sign-on procedure to be completed. 


File Processing in RJE Mode 


SML, operating in RJE mode, transmits files consisting of job control records 
and data to remote MULTI-LEAVING batch systems such as HASP and ASP. These 
files can originate from: 


e VM/370 users spooling files to RSCS 


e Remote terminals submitting card decks, through an NPT line driver with 
valid destination information in the ID card 


e Remote stations submitting card decks, through an SML line driver operating 
in HOST mode, with valid destination information in the ID card 


e Remote NJI/NJE systems submitting card decks. 
When the remote batch system has processed the data, printer and/or punch 


output is transmitted back to SML. This output is then printed or punched on 
the appropriate real I/0 device at the directly connected location. 
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Input File Processing in HOST Mode ) 


The remote station submits input to the RSCS machine through the remote card 
reader. This input can be directed to the virtual reader of a VM/370 user or 
to another remote terminal or location. Output processing at the remote 
station can usually be interrupted at any point to allow the transmission of 
input data. The specific procedure for interrupting output processing varies 
according to the remote hardware being used; this is explained in the 
"Operating Procedures™ for the specific remote station. When the input has 
been processed, output processing can be resumed from the point of 
interruption. 


A control card is placed in front of the deck to be sent from the remote 
station to the virtual machine card reader of a user or to another node, 
remote terminal or station. The format of this card is described under "ID 
Card Format from Remote Stations” in the preceding "Operation Description” 
section. If the remote system console is used to enter the ID data, upper 
case letters must be used. 


Output File Processing in HOST Mode 


line 1S created on the output to identify the originating userid, date, and 
time of transmission. Card decks punched at the remote terminal contain the 
source header information on the first card punched; the rest of the card is 
filled with asterisks. Printer files use a carriage control tape with channel 
l signifying the first print line. 


When printer and punch files are transmitted to a remote terminal, a header 
) 


In addition to header information, printer files are separated from one 
another by separator pages Which may be seen by the operator, at the edge of 
the unburst paper, to allow the operator to separate printed output. The 
separator page format is: 


— page eject 

- skip 61 lines 

- 5 lines of 130 asterisks per line 
~ 1 line of 130 underscores 

- 5 lines of 130 asterisks per line 
- 2 blank lines 

—- the source header line 

—- page eject 

—- the print file 
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The card and print file header information is: 


Col Field Meaning 
1 ll1ll1111 file origin location 
13 vmvmvmvm file origin virtual machine 
25 xx/ xx/ xx file origin date 
37 yy:yy:yy file origin time 
47 K.x.t. time zone 
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Remote Station Operator Commands 


The remote station operator, under control of SML in HOST mode, is allowed to 
use a subset of the RSCS commands. In general, the remote operator can issue 
commands that affect only his specific link. The RSCS commands are described 
in *RSCS Operator Commands”. A complete description of all commands is in 
"Appendix A: RSCS Commands”. 


Note: With the exception of the MSG and CMD commands, the linkid operand is 
not to be entered by a remote station operator when submitting commands 
to RSCS. 


w 


L Messages 


A subset of RSCS operator messages are printed on the remote station console. 
Generally, they are responses to commands originating at the remote station. 
For a key to the distribution of messages, see "Appendix B: RSCS Messages”. 


STARTING A POW LINE DRIVER (DMTPOW) 


Before a remote VSE/POWER system can sign on to POW, the appropriate task for 
that link must have been started during system start-up or by the RSCS 
operator. The START command for POW and the variables to be specified are: 


linkid [TYPE DMTPOW] [LINE vaddr] 


[Parm [Cnnn][/password] ] 


linkid is the location identifier of the remote station. 


DMTP OW is the name of the line driver to be used. This Specification 
overrides the driver name which may have been previously defined for 
the link. If no driver was previously defined for the link, this 
field must be specified. 
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vaddr is the virtual address of the communications line port. (vaddr is 
used only if the line port is to be other than one previously 
specified in a link definition.) 


Cnnn sets the remote CPUID number, indicating that POW will operate as a 
remote system to VSE/POWER with global remote ID of nnn. The valid 
range of nnn is 1-200 and corresponds to the REMOTE= definition on 
the PRMT macro specified in the VSE/POWER sysgen. If omitted, the 
default is 001. 


password 1S an optional operand preceded by a "/". The connection to 
VSE/POWER is validated by comparing the 1 to 8 character password 
with the one supplied by the VSE/POWER operator during the signon 
procedure. The identification consists of a one= to eight—character 
password that the remote VSE/POWER system must supply in its PSTART 
RJE command in order to connect to RSCS. 


For a general description of the START command, refer to "Appendix A: RSCS 
Commands”. 


Signing On 
The remote node (the VSE/POWER system) must initiate the sign-on procedure. | 
This requires that the VSE/POWER system has been generated with the POW2 ) 


parameter of the PLINE macro equal to YES, and the global remote ID specified 
on REMOTE of the PRMT macro equal to the Cnnn specification on the START 
command. 


Password verification is performed by comparing the password specified on the 
START command to the password supplied by the VSE/POWER operator. If a 
password is not supplied, it is assumed to be blanks. The passwords must 
match for the signon procedure to be completed. 


Upon completion of the sign-on procedure, POW and VSE/POWER begin hand—-shaking 
With each other. POW issues the messages: 


DMTPOW142I LINK ‘*linkid’ LINE ‘*vaddr’ CONNECTED 
DMTPOW9O05I SIGNON OF LINK ‘linkid* COMPLETE 


File Processing 


RSCS accepts files assumed to be VSE/POWER jobs and transmits them to the 
VSE/POWER system for execution. When the VSE/POWER system has completed its 
processing, it uses the routing information in the JECL records in the job to 
determine where to route the output. 


Job type input from the VSE/POWER system is not supported and is ignored. J 
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STARTING AN NPT LINE DRIVER (DMTNPT) 


Before a remote terminal can sign on to NPT, the appropriate task for that 
link must have been started during system start-up or by the RSCS operator. 
The START command for NPT and the variables to be specified are: 


STArt linkid [TYPE DMTNPT] [LINE vaddr] [Parm password] 


linkid is the location identifier of the remote terminal. 


DMTNPT is the name of the line driver to be used. This specification 
everrides the driver name that may have been previously defined for 
the link. If no driver was previously defined for the link, this 
field must be specified. 


vaddr is the virtual address of the communications line port. (vaddr is 
used only if the line port is to be other than one previously 
specified in the link definition.) 


Parm is a keyword signifying that one or more parameters follow. 


password is an optional operand of one to eight characters which designates a 
password that the remote station must supply to be allowed to 
connect to RSCS. If a password is not supplied in the START command 
or in the RSCS link table, the remote station is not required to 
Supply a password at sign-on time. 


For a general description of the START command, refer to “Appendix A: RSCS 
Commands”. 


Signing On to NPT 


After the operator has initialized the appropriate NPT task, contact may be 
established on a switched line by dialing the other location from either end 
of the link. If the line specified is a leased line, or if the above contact 
procedure has been successfully accomplished, a SIGNON card must then be 
entered via the card reader at the remote terminal. The SIGNON card must 
precede all other cards, and is used only once in each session. If the line 
drops, the SIGNON card must be re-entered via the card reader to restart the 
line. The SIGNON card designates the type of terminal, its features, and 
other information: 


linkid type [Bnnn] [CMPR] [Pnnn] [TRSx] [PCHx] [LPRT] 


[PWD=passwd] [TEXT] [HDRx] 


linkid is the location identifier of the remote terminal. If this does not 
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type 


Bnnn 


CMPR 


Pnnn 


TRS*x 


PCHx 


LPRT 


PWD= passwd 


TEXT 


HDR x 
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match the NPT task linkid of the START command, the SIGNON card is 


not accepted. } 


indicates the terminal type (2770, 2780, 3770, or 3780). 


specifies the line buffer extension in terms of the number of bytes 
(nnn> depending on the terminal type: 


Terminal Acceptable Values Default 


2770 128, 256, or 512 128 
27380 170 or 400 170 
3770 256 256 
3780 512 512 


specifies that the blank compression feature is present on the 2770, 
3770, or 3780. 


specifies the number of print positions (nnn) available at the 
remote printer, depending on the terminal type: 


Terminal Acceptable Values Default 

2770 120, 132, or 144% 120 7 

2780 120, 132, or 144 120 

3770 120, 132, or 144 120 

3780 120, 132, or 144% 132 

1s entered as TRSY if the remote terminal has the transparency 2.) 
feature and TRSN if it does not. The default is TRSN. 


is entered as PCHY if a punch is available at the remote terminal 
and PCHN if it is not. The default is PCHN. 


specifies that all print output, including messages, is to be 
directed to the line printer. This keyword is only valid when a 
terminal type of 3770 has been specified. If the keyword is 
omitted, the default print device is the console printer. 


¥ 


1S a password that must match the password entered by the operator 
in the START command or contained in the RSCS link table. If no 
password was entered in the START command or contained in the RSCS 
link table, this operand is not needed. 


specifies that all characters contained on a TN text printing chain 
are allowed to be transmitted to the remote printer. 


is entered as HDRN if no header page is wanted on printed output; 
the default, HDRY, specifies that a header page is wanted. 
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input File Processing 


The remote terminal submits input to the RSCS machine via its card reader. 
This input can be directed to the virtual reader of a VM/370 user or to 
another remote terminal or location. Output processing at the remote terminal 
can be interrupted at any point to allow the transmission of input data. When 
the input has been processed, the output processing can be resumed from the 
point of interruption. 


A control card is placed in front of the deck to be sent from the remote 
terminal to the virtual machine card reader of a user or to another node or 
remote station. The card's format is described under "ID Card Format from 
Remote Stations” in the preceding “Operation Description™ section. 


If the userid on the ID card is invalid, RSCS spools the punch file to the 
real punch. 


Output File Processing 


When print and punch files are transmitted to a remote terminal, a header line 
is created on the output to identify the originating userid, date, and time of 
transmission. Card deck5 punched at the remote terminal contain the source 
header information on the first card punched; the rest of the card is filled 
With asterisks. Printer files use a carriage control tape with channel 1 
signifying the first print line. 


In addition to header information, printer files are separated from one 
another by header pages which may be seen by the operator, at the edge of the 
unburst paper, to allow the operator to separate printed output. The format 
of the separator page is: 


- page eject 

- skip 61 lines 

- 5 lines of 130 asterisks per line 
—~ 1 line of 130 underscores 

- 5 lines of 130 asterisks per line 
- 2 blank lines 

- the source header line 

—- page eject 

- the print file. 


The card and print file header information is: 


Col Field Meaning 
1 lll1llilil file origin location 
13 vmvmvmvm file origin virtual machine 
25 xx/ xx / xX file origin date 
37 yy:yy:yy file origin time 
4&7 K.xK.t. time zone 
55 WAS THE ORIGIN 
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Remote Terminal Operator Commands 


The remote terminal operator may use a subset of the RSCS commands. The 
commands are punched on cards, beginning in column 1, one per card, and are 
read on the remote card reader. Command cards must precede the ID control 
card for an input file. In general, the remote operator can issue commands 
that affect only his specific link. The commands are described under "RSCS 
Operator Commands”. A complete description of all commands is in "Appendix A: 
RSCS Commands”. 


Note: With the exception of the MSG command, the linkid operand must not be 
entered by a remote terminal operator when submitting commands to RSCS. 


NPT Messages 


A subset of the RSCS operator messages is printed on the remote terminal 
printer. Due to the unavailability of a separate console printer for 
messages, and the resulting confusion which would ensue if messages Were mixed 
With printer output, DMTNPT provides for a message queue. When the remote 
printer has completed processing an output file, the enqueued messages are 
transmitted and printed. Refer to "Appendix B: RSCS Messages” for a key to 
the distribution of messages. 


STARTING AN RPT LINE DRIVER (DMTRPT) 


Before a VM/370 file can be spooled to an IBM 3270 Information Display System 
printer, an RPT line driver task must be started, either automatically during 
system start—up or by the RSCS operator. The START command for RPT, and the 
variables to be specified are: 


linkid [TYPE DMTRPT] Parm DA—APL 
[LINE vaddr] DA—TEXT 

AT—APL 

AT—TEXT 


Bnnnn 
Pnnn 
Lnn 
VFC 
NOSEP 
NOCOMP 
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| where: 


| linkid 


| TYPE DMTRPT 


LINE vaddr 


Parm 


DA—APL 
DA-TEXT 


AT—APL 


AT—TEXT 


is the one-to-eight-—character name of the 3270 printer to be 
activated or modified. 


indicates that the DMTRPT line driver is to be used. 


designates the virtual device address (vaddr) of the line port to 
be used by the link. 


indicates that START command parameters follow this keyword. A 
combination of parameters can be given in any order. Note that 
DA-APL, DA-TEXT, AT-APL, and AT-TEXT are mutually exclusive. Any 
parameters not specified will assume the default value indicated 
below. 


specifies that the printer is equipped with the Data Analysis—APL 
feature and that all files containing internally represented 
EBCDIC special APL characters are to be translated to the 
appropriate two-byte I/0 interface codes. Specifying either 
PRT=TEXT or PRT=NOTR on a CP TAG command will override the DA=APL 
keyword specified on the START command for all files controlled by 
that TAG command. All other files will default to the APL 
translation. 


specifies that the printer is equipped with the Data Analysis—APL 
feature and that all files containing internally represented 
EBCDIC special Text characters are to be translated to the 
appropriate two-byte I[/0 interface codes. Specifying either 
PRT=APL or PRT=NOTR on a CP TAG command will override the DA-TEXT 
keyword specified on the START command for all files controlled by 
that TAG command. All other files will default to the Text 
translation. 


specifies that the printer is equipped with the APL/Text feature 
and that all files containing internally represented EBCDIC 
special APL characters are to be translated to the appropriate 
two-byte I/0 interface codes. Specifying either PRT=TEXT or 
PRT=NOTR on a CP TAG command will override the AT-APL keyword 
specified on the START command for all files controlled by that 
TAG command. All other files will default to the APL translation. 


specifies that the printer is equipped with the APL/Text feature 
and that all files containing internally represented EBCDIC’ 
special Text characters are to be translated to the appropriate 
two-byte I/0 interface codes. Specifying either PRT=APL or 
PRT=NOTR on a CP TAG command will override the AT-TEXT keyword 
specified on the START command for all files controlled by that 
TAG command. All other files will default to the Text 
translation. 


Note: If neither DA-—APL, DA-TEXT, AT—APL, or AT=TEXT is specified, the normal 
one=byte EBCDIC translation is performed. 
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1 
Bnnnn 


Pnnn 


Lnn 


NOSEP 


NOCOMP 


Note: 


is the buffer size in the 3271, 3272, 3274, or 3276 control unit. 
The following buffer sizes are valid: 480, 960, 1920, 2560, 3440, 
and 356%. The correct buffer size has to be specified on the 
START command to match the buffer size on the control unit being 
used. Tf this operand is omitted, the buffer size defaults to 
1920. 


specifies the number of print positions available on the 3270 
printer platen. The value may be either 120, 126, or 132. If 
this parameter is omitted, the number of print positions defaults 
to 132. 


specifies the number of lines per page on the type of form 
inserted in the 3270 printer. The value may be from 0 to 99. A 
value of 0 indicates that no page ejects will be done by the line 
driver. If this parameter is omitted, the length of a page 
defaults to 66. 


specifies that the printer has the vertical forms control feature. 
When the VFC operand is specified, the page length must be set 
manually on the printer. If the VFC operand is omitted, the 
default is no vertical forms control, and vertical spacing is 
achieved through multiple New Line operations. 


specifies that there will be no header and separation page between 
files. If this operand is omitted, the default is to print a 
header and separation page. 


specifies that the line driver will not perform blank compression. 
If this operand is omitted, the default is to compress occurrences 
of five or more blanks. 


For a general description of the START command, refer to “APPENDIX A: 


RSCS COMMANDS*. 


PRINTER OPERATIONAL CHARACTERISTICS 


The paper in the printer should be positioned one line below the perforation 
in the continuous form paper to initially set the top of a page. The DMTRPT 
line driver assumes that the paper is in position to be printed on the very 
first line of the page. Alignment should be done with the Power ON/OFF switch 
in the OFF position or with the HOLD PRINT switch depressed to prevent the 
possibility that printing might begin while the paper is being moved. 
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When a file is ready to be printed, the following will take place: 


1. The header will print, beginning on the top line. 

2. Spacing will be performed to position the printer at the top of the 
next page. 

3. The contents of the file Will be printed. 

4. At the end of the file, the printer will skip to the top of the next 


page. 


The Vertical Forms Control feature (VFC) allows the user to manually set the 
forms length on printers started with the VFC parameter. DMTRPT will then 
issue a Forms Feed to skip to the top of the next page. It is the user's 
responsibility to align the vertical form control with the top of a page when 
changing forms or at initial setup, and to ensure the the Lnn PARM operand 
matches the VFC setting. Refer to the appropriate Operator's Guide (see 
"Related Publications” in the Preface) for instructions on how to set the VFC 
control for a particular printer. 


If the Power ON/OFF switch on the printer is turned OFF while printing is 
taking place, no error condition is sent to VM/370, therefore its occurrence 
cannot be detected by the DMTRPT line driver. When the switch is put back 
on, only a normal device—end condition will be generated. DMTRPT will send 
the next buffer to be printed, and several lines of data and line position may 
be lost. 


If for any reason the cover on the printer (Models 3284, 3286, and 3288 only) 
is raised with the switch turned ON, an intervention required condition will 
be generated. DMTRPT will detect this condition and wait for the cover to 
lowered. When the cover is back in proper position, DMTRPT will resend the 
entire buffer, but line position may be lost and some lines may be duplicated. 
If the cover is raised more than twice on the same buffer, the file will be 
flushed and line position may be lost. The end of one buffer and the start of 
the next can sometimes be detected by the slight pause between lines. 


Based on these considerations, the following procedures can be used to flush a 
file on the 3270 printer. 


FLUSHING FILES ON A 3270 PRINTER 


1. While the printer switch is on, and the printer is printing, raise and 
lower the printer cover two times. 


z2. Raise and lower the cover once more, and observe the line that prints. 


| 3. Either the header line from the next file will print, or if no more files 


are queued all printing will cease. 


| 4. In either case raise the cover once more. While the cover is in the up 
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pos¥#tion, adjust the paper to a new page to recover printing 
hronization for the next file. ) 

5. Lower the cover and printing Will resume at the beginning of the next 

file. If the header line has already printed, it will be reprinted and 

then the contents of the file will print. 


Note: This procedure assumes that the cover was never raised on the present 
print buffer. The only difference if it was raised, will be fewer number of 
cover raises before the file is flushed. If printing is being done on a 
remote printer, wait a few seconds before lowering the print cover. 


FLUSHING SHORT FILES ON A 3270 PRINTER 


1. While printing ts going on, turn the printer switch off and then on. 
2. Observe the line that prints. 


3. If it is mot the beginning of a header line, the current file is not 
through flushing. Go to step l. 


6. If it is the beginning of a header line, flushing is complete and a new ; 
file is about to print. Go to step 6. 2 


5. If no printing occurs, the flushing is complete and there are no other 
files waiting to be printed. Go to step 6. 


6. In either case 4 or 5 raise the printer cover. While the cover is in the 
up position, adjust the paper to a new page to recover printing 
synchronization for the next file. 


7. Lower the cover and printing will resume at the beginning of the next 
file. If the header line was already printed, it will be reprinted and 
then the contents of the file will print. 


Note: If printing is being done on a remote printer, wait a few seconds 
between powering the printer off and on. 


STARTING A VMB LINE DRIVER (DMTVMB) 


Before communication with a remote VM/370 system can begin via BSC lines, the 
VMB line driver task for the associated link must be started. This may be 
done automatically during system start-up or manually by the RSCS operator. 
The START command for VMB and the variables to be specified are: 
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STArt linkid [TYPE DMTVMB] [LINE vaddr] [Parm tpass [rpass]] 


linkid is the location identifier of the remote system. 


DMTVMB is the name of the line driver to be used. This specification 
overrides the driver name that may have been previously defined for 
the link. If no driver was previously defined for the link, this 
field must be specified. 


vaddr is the virtual address of the communications line port. (vaddr is 
used only if the line port is to be other than one previously 
specified in the link definition.) 


Parm is a keyword signifying that one or more parameters follow. 


tpass 1S an optional operand, one to eight characters long, that specifies a 
password to be transmitted during the sign-on sequence. 


rpass 1S an optional operand, one to eight characters long, that specifies a 
password that must be received from the remote system before file 
transfer is initiated. If the transmit password (tpass) is specified 
and rpass is not, a default rpass value the same as tpass results. 


For a general description of the START command, refer to "APPENDIX A: RSCS 
Commands”. 


STARTING A VMC LINE DRIVER (DMTVMC) 


To establish communication with a remote VM/370 system linked through a 
channel=to-channel adapter, a VMC line driver task must be started. This may 
be done automatically during system start-up or manually by the RSCS operator. 
The START command for VMC and the variables to be specified are: 


STArt linkid [TYPE DMTVMC] [LINE vaddr] 


linkid is the location identifier of the remote node. 


DMTVMC is the name of the line driver to be used. This specification 
overrides the driver name that may have been previously defined for 
the link. If no driver was previously defined for the link, this 
field must be specified. 


vaddr is the virtual address of the communications line port. (vaddr is 
used only if the line port is to be other than one previously 


specified in the link definition.) 


For a general description of the START command, refer to "Appendix A: RSCS 
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Commands”. 


STARTING AN NJI LINE DRIVER (DMTNJI) 


Communication with systems other than VM/370 is typically managed by the NJI 
line driver. The NJI line driver task for the desired link may be started 
automatically during system start-up or manually by the RSCS operator. The 
START command for NJI and the variables to be specified are: 


linkid [TYPE DMTNJI] [LINE vaddr] |Parm Buff=nnnn ] 
Rest=nnnn ] 
RLPass=password 
RNPass=password 
TLPass=password 
TNPass=password 


Any combination of the parameters following the Parm keyword may be 
entered, separated from each other by blanks. 


linkid is the location identifier of the remote station. 


DMTNJI is the name of the line driver to be used. This specification 
overrides the driver name which may have been previously defined for 
the link. If no driver was previously defined for the link, this 
field must be specified. 


vaddr is the virtual address of the communications line port. (vaddr is 
used only if the line port is to be other than one previously 
specified in a link definition.) 


Parm is a keyword signifying that one or more parameters follow. 


Buff=nnnn 
specifies the maximum size record that this link can accept from the 
communications adapter. This may range from 300 to 3976 bytes, with a 
default of 400. 


Rest=nnnn 
specifies the partial nodal resistance of this NJI connection. This 
number may range from 2 to 2000, with a default of 200. See System 


Programmer’s Library: Network Job Entry Facility for JES2, $C23-0003. 
RLPass=password 


specifies the line password required from the remote system before the : ) 
transmission of data is initiated. The password may range from one to 
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eight characters.’ If the correct password is not received at line 
connection time, RSCS deactivates the link and issues error message 
DMTNCM914E. 


RNPass=password 
specifies the node password required from the remote system before 
the transmission of data is initiated. The password may range from 
one to eight characters. If the correct password is not received at 
line connection time, RSCS deactivates the link and issues error 
message DMTNCM914E. 


TLPass=password 
specifies the line password to be transmitted to the remote system at 
line connection time. The password may range from one to eight 
characters. 


TNPass=password 
specifies the node password to be transmitted to the remote system at 
line connection time. The password may range from one to eight 
characters. 


For a general description of the START command, refer to "Appendix A: RSCS 
Commands”. 


RESTARTING A LINE DRIVER 


Normally a line driver will need to be restarted only if it has been 
deactivated by a DRAIN or FORCE command. Under these conditions issuing the 
START command for the line driver in question reactivates it. 


If a problem occurs in a link's telecommunication facility, the procedure 
required depends on the line driver type. 


The three RSCS line drivers using the MULTI-LEAVING protocol (DMTSML, DMTPOW, 
and DMTNJI) provide a restart facility in the event of 40 consecutive 
three-second timeouts on the telecommunications adapter. When this condition 
occurs, RSCS deactivates the link and causes the execution of an exec file 
With the filename identical to the linkid of the link being deactivated. This 
exec (user generated) would normally contain a START command for the link just 
deactivated, as well as any other valid RSCS commands. For example, an exec 
file to automatically restart the NEWYORK link could be this one-line file, 
NEWYORK RSCS: 


START NEWYORK 


Issuing a DRAIN or FORCE command to a MULTI-LEAVING link does not cause the 
link's automatic restart execution file to be executed. 


The VMB and VMC line drivers do not deactivate when transmission line problems 


occur. If a line fails, RSCS issues a LINK DISCONNECTED or LINK DISABLED 
message, depending on the problem. The line driver then temporarily suspends 
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transmission and tries to reinitialize and reenable the line automatically. 


If the problem is momentary, RSCS issues the READY FOR CONNECTION TO LINK and 
LINK DATASET READY messages as the line is reestablished. Transmission of 
files then resumes. 


If the problem persists, the operator should check for any obvious problem in 
the data set or modem in the case of a leased line. For a dial-up line the 
operator should redial to reestablish the line connection. Transmission of 
files then resumes at the point of interruption. 


The NPT and RPT line drivers deactivate when a severe line interruption 
occurs. In this case the line problem must be resolved. After reestablishing 
a functioning transmission line, the RSCS operator must issue a START command 
to the line drivers to reestablish the link. 


DYNAMIC RECONFIGURATION 


Commands enable the RSCS operator to dynamically alter the RSCS configuration. 
Entries in the link and routing tables can be added, deleted, or modified 
while the system is running. This enables the RSCS operator to respond 
immediately to changes in the operating environment of his node. If the 
normal transmission path for a link becomes unavailable, the RSCS operator can 
alter the routing table to send files via another link that provides a path to 
the destination. If it becomes necessary to process a particular class of 
files first, the RSCS operator can redefine a link in the link table to access 
only the specified class of file for transmission. 


CHANGING THE ROUTING TABLE 


To change an entry in the routing table, issue a ROUTE command from the RSCS 
operator's console. Specify the location ID for the remote location whose 
routing is to be modified or redefined. Also specify "TO linkid"™ defining the 
link to process the files directed to the remote location. RSCS issues a 
message in response to the ROUTE command, reporting the result. Files 
awaiting transmission are automatically reenqueued following execution of a 
ROUTE command. For a detailed description of the ROUTE command, see “Appendix 
A: RSCS Commands”. 


Changes to the routing table remain in effect until the next RSCS IPL. 
Permanent changes can only be made by altering the RSCS directory. 
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CHANGING THE LINK TABLE 


To change an entry in the link table, issue a DEFINE or DELETE command from 
the RSCS operator's console. Before altering or deleting an entry for an 
active link, first make the link inactive by issuing a DRAIN command to that 
link. 


The DEFINE command creates temporary new link entries, redefines an entry that 
Was deleted, or alters an existing entry in the link table. The DELETE 
command makes a link temporarily unavailable to RSCS. 


RSCS issues messages in response to both the DEFINE and DELETE commands. For 
a detailed description of the DEFINE and DELETE commands, see "Appendix A: 
RSCS Commands”. 


Changes to the link table remain in effect until the next RSCS IPL. Permanent 
changes can only be made by altering the RSCS directory. 


OPERATING DIFFERENCES FROM EARLIER PROGRAMS 


RSCS Networking can coexist on the same processor with the RSCS component of 
VM/370 provided that each has its own system disk. 


Command improvements were made in the VNET PRPQ which have been carried 
forward in RSCS Networking. These create minor differences for the operator 
accustomed to running the RSCS component of VM/370: 


e The LOG and NOLOG options on the CMD command in the RSCS component of 
VM/370 have been moved to the TRACE command in RSCS Networking, where they 
more logically belong. 


e The operands ALL, ERROR, and END on the TRACE command have been replaced by 
the operands SUM and NOSUM. The ALL and END operands are equivalent to the 
SUM and NOSUM operands, respectively. The ERROR operand has been dropped 
because the information it provided 1s contained in that provided by the 
ALL operand. 


e The STAT option on the QUERY “"linkid® operand has been dropped. This 
information is provided by the QUERY "locid™ operand. In the RSCS 
component of VM/370, the concept of "linkid”™ and “"locid™ are the same. In 
RSCS Networking, “"locid” refers to the identifier of the final destination 
to which data is sent, while “linkid” refers to the identification of the 
next destination to which the data is sent. 


e The syntax of the following command has been changed in RSCS Networking 
from that of the VNET PRPQ: 
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QUERY FILE spoolid VNET 
has been changed to 


QUERY FILE spoolid RSCS 


3-34 IBM VM/370: RSCS Networking —- Ref and Operations 


Part 4: VM/370 User’s Guide 


Part 4 is a guide for the VM/370 
user who needs to use the network. 
Part 4 covers: 


¢ The commands needed to use RSCS 
for file transmission. 


e Examples of transmitting files 
via RSCS. 


e Messages a VM/370 user may expect 
from RSCS. 


e The commands needed to use RSCS 
for special message transmission. 


Part 4: VM/370 User's Guide 4-1 


User Commands 


As a VM/370 user, you request file transmission services by using the VM/370 
CP SPOOL and TAG commands and then passing one or more files to RSCS. You may 
also use the VM/370 CP SMSG command to send special messages via RSCS to 
remote virtual machines or to request status information about RSCS or about 
remote VM/370 systems. 


VM/370 SPOOL COMMAND 


All files to be transmitted via RSCS must be spooled to the RSCS virtual 
machine. The basic form of the CP SPOOL command you use with RSCS is: 


Printer 
PRT 
< PUnch > [TO] rscsid [Class c]) [COpy=[x]nnn] 
PCH [FOrm=ccccecccc] 
CONsole [CHars=name] 
vaddr [FLash=name nnn] 
[MOdify=name] 
[FCB=name] 
Printer denotes all printer class device output. 
PRT 
PUnch denotes all punch class device output. 
PCH 
CONsole denotes all console class device output. 
vaddr denotes all output from the specified virtual device address. 
rscsid is the identifier of the RSCS virtual machine. 
Class c specifies the spool class of the device; c 15 a one-character 
alphameric field whose value can be A through Z, or 0 through 9. 
COpy=[x]nnn 


specifies the number of copies to be made of the file. The maximum 
value of nnn (number of copies) is 255 when you are using a VM/SP 
host system, and 99 for all others (leading zeros are optional). 
The optional asterisk (*) can be specified on print files to be 
spooled to a 3800 printer to perform the file duplication 
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Cc 


internally one page at a time. This option prevents retransmission 
of the print file to the virtual output device every time a copy is 
desired. 


FLash=name nnn 
signifies that a forms overlay contained in the 3800 printer be 
superimposed onto certain pages of the output. The name, one to 
four characters, identifies the forms overlay to be used in the 
projection. The number (nnn) specifies that the first nnn pages of 
output are to be superimposed. Its maximum value is 255 when you 
are using a VM/SP host system, and 99 with any other. The default, 
0, indicates that no superimposing is desired. 


MOdify=name 
assigns a copy modification module to be used when printing a file 
on the 3800. This function makes it possible to alter text either 
by preventing printing of certain information or by adding labels 
to output. The name must be one to four characters. If the name 
is omitted, the file prints normally Without modification. 


CHars=name specifies the character arrangement table used used when printing a 
file. The name must be from one to four characters. It determines 
which writable character generation module (WCGM) is used for 
printing on the 3800. 


FCB=name controls the vertical spacing of output on a page. The name must 
be from one to four characters. 


FORM=cccccccc 
specifies the one= to eight—-character form name or I1.D. for the 
file. 


You can nullify any previous or existing settings of the CHARS, MODIFY, or FCB 
options by specifying NULL in the name field of these operands. The FLASH 
setting can be nullified by specifying a flash count of zero. In this case, 
the FLash name is meaningless. 

In each of these cases, CP changes the CHARS, MODIFY, FCB, or FLASH names to 
blanks. 


In the case of FORM, there is always a default name present even if you do not 
explicitly specify one. When spooling a file to RSCS for transmission to a 
remote system (for subsequent printing), the FORM name can be nullified by 
specifying NULL in the name field. In this case, CP keeps the name as “NULL” 
rather than changing it to blanks, although RSCS recognizes this special form 
name and causes the default name at the remote system to be used for the 


aa Ge 


actual printing of the file. 


Note: You can specify additional options; see the VM/370: Command Language 
Guide for General Users for details. 
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VM/370 TAG COMMAND 


You use the VM/370 CP TAG command to enter or query data in the file tag. The 
command has three functional formats; you can: 


e¢ Prespecify the tag for all output files from a particular category of 
output devices or from a single output device 


e¢ Replace the tag for an existing closed spool file 
e Display the tag for a closed output file. 


The TAG command syntax is: 


Printer 
PRT 


PUnch > locid userid priority [JOB] 
PCH JOB 

CONSole 

vaddr 


userid | priority [JOB] 
JOB 


Printer 
PRT 
PUnch 
PCH 
CONsole 
vaddr 


Flle spoolid 


The first operand specifies the function to be performed; the other operands 
provide additional details. The optional locid, userid, priority, and JOB 
operands for the TAG DEV and TAG FILE functions make up the tag data. The 
entire command line to the right of the second operand (beginning with the 
leftmost non-blank character to a maximum of 136 characters) becomes the new 
tag for the specified device, device class, or spool file. If no tag data is 
specified, the tag is set to blanks. 


DEV allows you to initialize, replace, or delete the tag data 


associated with an output device. All spool files generated by the 
device specified in the second operand will contain the tag data 
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File 


QUery DEv 


QUery File 


Printer 
PRT 


PUnch 
PCH 


CONsole 


vaddr 


spoolid 


locid 


userid 


priority 


JOB 


specified in the following operands. 
operands, the tag is set to blanks. 


If there are no following 


allows you to replace the entire tag of any spool file queued on 
your virtual reader. The spool file is identified by the second 
operand and the new tag is specified in the following operands. 
This allows you to correct the tag of a file returned to your 
reader by RSCS because of an invalid address in the tag. If there 
are no following operands, the tag is set to blanks. 


allows you to display the current setting of the tag associated 
with the output device or device class specified in the third 
operand. 


allows you to display the tag of any closed spool file. The 
particular file is specified by the third operand. Except for 
VM/SP, only files queued on your virtual reader can be displayed 


denotes all printer class devices. 


denotes all punch class devices. 


denotes all console class devices. 


is the virtual device address of a virtual unit record device or 
console. 


is the identification number assigned to a spool file by the VM/370 
spooling facility. The numbers range from 1 to 9900. 


identifies the destination location for output generated by the 
virtual device. 


identifies the remote virtual machine, work station, or 3270 
printer at the specified location that is to receive the output 
generated by this device. If userid is not applicable (as in NPT, 
POW, RPT, and SML support), or if the output is destined for the 
system unit record device at the specified location and priority is 
to be specified, you must specify a dummy userid, such as "SYSTEM". 


is the requested transmission priority (a decimal number 0-99, 
defaulting to 50); a lower numerical value signifies a higher 


priority. 


indicates that the output of this device is to be transmitted as a 
job. 
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TAG QUERY COMMAND RESPONSES 


PRINTER 
PRT 

TAG QUERY DEV < PUNCH > 
PCH 
CONSOLE 
vaddr 


Displays the tag associated with each device of the specified class as: 


| PRT | repeated for 
< PUN > vaddr TAG: each device in 
CONS the specified 
vaddr class 
TAGCTEXE Cas etee Mes eeeee 


TAG QUERY DEV vaddr 
Displays the tag associated with the specified device as: 


| prt ] 


< PUN > vaddr TAG: 


— 


tagtext.......... 
if a tag exists 


TAG NOT SET 


if the TAG command was never issued to that device. 
TAG QUERY FILE spoolid 
Displays the tag of the specified file as: 
tagtext.......... 
if a tag exists 
(TAG BLANK) 
if the tag is all blanks 
(TAG MISSING) 
if the file did not contain a tag because it was either an 
input file from the real card reader or was an output file 3 


generated before VM/370 Release 2 PLC ll. 
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TAG DEV COMMAND FOR 3270 PRINTER FILES 


When a file is to be printed on an IBM 3270 Information Display System printer 
via RSCS, the syntax of the TAG command is: 


DEv vaddr locid [userid [priority [PRT=option]]] 


The PRT keyword can be used to override any specification of DA-APL, DA—-TEXT, 
AT—APL, or AT=TEXT on the RSCS START command for the DMTRPT line driver. If 
no APL— or Text-related PARM operands were specified When the line driver was 
started, the PRT keyword iS ignored. If the PRT keyword is not specified, the 
default translation specified on the RSCS START command will be used. 


The “option” operand of the PRT keyword can be one of the following: 


APL specifies that internally represented EBCDIC special APL characters 
Will be translated to the appropriate two-byte I/O interface codes. 


TEXT specifies that internally represented EBCDIC special Text 
characters will be translated to the appropriate two-byte I/0 
interface codes. 


NOTR specifies that internally represented EBCDIC special APL or Text 
Characters will not be translated to the two-byte I/O interface 
codes. 


User Commands 4-7 


TAG DEV COMMAND FOR OUTPUT FILES GOING TO NON-—VM/370 NJI/NJE SYSTEMS 


Additional parameters may be placed on the VM/370 TAG command when interfacing 
to a non-VM/370 NJI/NJE system for the transmission of output (not jobs). 


DEv vaddr locid 


FCB[C])=bufrname 
FORMS[F]=formsname 
ucs[T]=charset 
INDEX[I]=offset 
EXTWTR[W])=writername 
SYSOUT=outclass 
DEST=remoteid 
userid | priority | BURST[B]={Y|N} 
OPTCD=J 
CHARS[X]=tablename 
COPYG[G]=nnn 
FLASH[O)=overlay 
FLASHC[Q]J=nnn 
MODIFY[Y]=modi fy 
MODTRC[M]J=n 


Before specifying any of the parameters in this last group 
be sure the subsystem at the output location supports these 
features. You may specify any combination of these 
parameters, separated by blanks, up to a total tag length 
of 136 characters. The accepted abbreviation for each 
keyword is shown enclosed in []. 


The basic parameters are as defined in the preceding description; the 
additional parameters are: 


FCB= indicates the forms control buffer for printing the output of this 
device. This specification can be from 1 to 8 characters. 


FORMS= indicates the special forms for printing the output of this device. 
This specification can be from 1 to 8 characters. 


UCS= indicates the universal character set for printing the output of 
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INDEX= 


EXTWTR= 


SYSOUT= 


DEST= 


this device. This specification can be from 1 to 8 characters. 


indicates the data set indexing position offset for a 3211 printer. 
This value may range from 1 to 31. 


indicates the external writer to process the output of this device 
when it iS printed or punched at a remote location. 


indicates the output class at the receiving node. This 
specification is one character and represents a valid output class 
at the receiving node. If not specified, the default class for all 
output is A. 


indicates the name of a remote workstation at the receiving node. 


You can specify the following parameters if the receiving subsystem is to 
print the data on an IBM 3800 printer: 


BURST= 


OPTCD=J 


CHARS= 


COPYG= 


FLASH= 


FLASHC= 


MODIFY= 


MODTRC= 


indicates whether the output from this device should be threaded 
into the Burster-—Trimmer-—Stacker on a 3800 printer. This parameter 
must be either Y or N. 


indicates that each line of data produced by this device contains a 
table reference character for a 3800 printer. 


indicates the names of character arrangement tables, which define 
the characters for printing on a 3800 printer. This specification 
can be from 1 to 8 characters; you may specify it up to four times 
(once for each table). 


indicates the copy grouping for the output of this device when 
printed on a 3800 printer. Each group can range from 1 to 255. You 
may specify it up to eight times, indicating eight copy groups. 


indicates the name of the forms overlay frame to be used when 
printing the output of this device on a 3800 printer. This 
specification can be from 1 to 8 characters. 


indicates the number of the total copies of the output of this 
device on which the forms overlay is to be printed on a 3800 
printer. This parameter can range from 1 to 255. 


indicates the copy modification module to be used in modifying the 
data produced by this device when printed on a 3800 printer. This 
specification can be from 1 to 8 characters. 


indicates the table reference character for selecting the character 
arrangement table is to be used when printing the output of this 
device on a 3800 printer. This parameter can be 0, 1, 2, or 3. 


RSCS ignores the remainder of the 136—byte tag. 
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Note: Certain of the above parameters are equivalent to options on the CP 


SPOOL command and can be specified on either the TAG or SPOOL commands for 
files that are destined for non-VM/370 NJI/NJE systems. These are: 


TAG command SPOOL command 


CHARS= CHARS 
FLASH/FLASHC= FLASH 

MODIFY= MODIFY 

FCB= FCB 

CoPYG= COPY [x]nnn 


FORMS= FORM 


If any of these parameters are specified on both the TAG and SPOOL commands, 
the TAG command operands will override the corresponding SPOOL command 
operands. 


Also, it should be noted that the support provided in VM/370 for the 
specification of character arrangement table names (CHARS) and copy groups 
(COPY [x]nnn) is different than that provided in an NJI/NJE system such as 
MVS. VM/370 provides for one CHARS name and one copy group specification, 
while MVS provides for four CHARS names and eight copy groups. If multiple 
specifications of either of these options are required, then they must be 
specified on the CP TAG rather than the CP SPOOL command. 


VM/370 SMSG COMMAND 


A virtual machine user may use the CP SMSG (special message) command to send 
messages via RSCS to remote virtual machines or to request status information 
about the local RSCS, a remote RSCS, or a remote VM/370 system. The text of a 
SMSG command can be an RSCS MSG command, an RSCS CMD command, or command text 
for local RSCS status information; the text of that CMD command can be an RSCS 
QUERY command or an RSCS CPQUERY command. 


The syntax of SMSG used with RSCS is: 


|| 


< MSG > locidm userid message text > 


ha 


CMD locidc command text 


command text 
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rscsid 


MSG 
M 


locidm 


userid 


message text 


CMD 


locidc 


command text 


is the identifier of the RSCS virtual machine. 


signifies that the following operands are RSCS MSG command 
operands. 


is the one= to eight=-character location identifier of the 
location to receive the specified message text line. 


is the one— to eight-character identifier of a user at the 
specified location, or the identifier "RSCS™ for a remote RSCS 
operator’™s console. If the message is to be sent to a remote 
batch terminal, the userid field is ignored, but a dummy entry 
must be included to avoid deletion of the first word of the 
message. 


is a string of alphameric characters comprising the message to be 
presented to the specified location and user. The maximum length 
of this string i585 120 characters. 


Signifies that the following operands are RSCS CMD command 
operands. 


15 the one= to eight= character location identifier of the remote 
system to receive and execute the command specified in the 
command text. 


715 any command up to 120 characters acceptable to the system 
which is to receive the command. Any text greater than 120 
characters will be truncated. The RSCS commands QUERY and 
CPQUERY are acceptable as command text. For details on these 
commands, refer to "Appendix A: RSCS Commands". 
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User Examples 


Following are several examples of RSCS usage for file transmission. The 
examples presented here provide samples of the types of facilities available. 
However, they do not show complete examples of using RSCS. If you use a mixed 
environment of NJE/NJI subsystems, refer, for guidance, to the related 
publications listed in the Preface. 


SIMPLE SPOOLING AND TAGGING 


To specify that all subsequent printer output is to be transmitted to Houston, 
you would enter the commands: 


tag dev printer houston 
spool printer to net 


where HOUSTON is the location identifier of the receiving station and NET is 
the userid of the originating RSCS virtual machine. You may enter the 
commands in either order. 


If a particular output device is to have its output transmitted to Palo Alto J 
With a priority of 10 and no userid specified, you would enter: 


tag dev 00d paloalto system 10 
spool 00d to net 


where 00D is the virtual output device address, PALOALTO is the location of 
the receiving station, SYSTEM is a dummy userid entry, 10 is the priority 
value, and NET is the userid of the originating RSCS virtual machine. 


SPECIFYING DESTINATION OF VM/370 VIRTUAL OUTPUT 


SS ES 


Assume you are a CMS user on a VM/370 system known as CHICAGO and you want to 
print your PROFILE EXEC file on the BOSTON system printer. Assume the network 
configuration shown in Figure 9 in Part 2 of this manual. 


Assume that NET is the userid of the RSCS virtual machine in the CHICAGO 
system and that the CHICAGO to BOSTON 114k is temporarily inactive. The 
following illustrates your console: 


spool printer to net 
R; 
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tag dev printer boston system 
R3 


pr profile exec 
PRT FILE 0150 TO NET COPY 001 NOHOLD 
R; 


12:59:26 
MSG FROM NET : SENT FILE 0150 (0150) ON LINK 
TORONTO TO BOSTON SYSTEM 


12:59:36 
MSG FROM NET : FROM TORONTO: SENT FILE 0386 (0150) 
ON LINK BOSTON TO BOSTON SYSTEM 


Note that the spool ID assigned at the originating system by VM/370 is 
returned in each network response message as the file proceeds through the 
network. Also, the path the file took to its final destination was determined 
by RSCS. You specified only the final destination. 


USING AN EXEC FILE TO SIMPLIFY YOUR ENTRIES 


EXEC files are a very powerful way to handle common tasks like sending files 
via RSCS to other users in a network. You can build EXECs that include 
operations such as: 


e Interacting with the user to acquire needed parameters 
e Validity checking of the parameters passed to it 


e Inserting values for variables in commonly used code and then executing 
that code. 


The primary advantage of EXECs is that they simplify the user’s role; they 
tailor the user’s input to just what is needed, and relieve the user from 
making lengthy entries at the terminal. They also free the novice user from 
needing to know details of a program's implementation. Writing EXEC routines 
1s described in the VM/370 CMS User’s Guide, GC20-13819. 


The following three examples show EXEC routines that send files to VM/370 
users on remote systems. The first EXEC is a primitive example that shows 
basic principles only. The second example is a more complete EXEC for sending 
a file to a remote VM/370 user whose nickname is kept in a distribution list 
file. The third example illustrates an EXEC for sending a file to all remote 
VM/370 users on a given distribution list. 


The second and third examples use the CMS functions CONWAIT and DESBUF to 
clear the console stack before proceeding. The second and third examples also 
include their own documentation, which a user can call forth by entering the 
EXEC name and a single question mark as the only operand. These examples 
conclude with the punch spooled off and its tag set to null; you may wish to 


User Examples 4-13 


note the spool and tag settings for the punch before you invoke the EXEC and 
then restore these settings after conclusion of the EXEC. 


A Simple EXEC for Sending a File to a Remote VM/370 User 


The following EXEC, called SEND, uses its operands to perform the basic SPOOL, 
TAG, and DISK DUMP operations to pass a file to the local RSCS virtual machine 
(named NET). 


&LOCID = &1 

&USERID = &2 

&FNAME = &3 

&FTYPE = &4 

&FMODE = 2&5 

CP SPOOL OOD TO NET 

CP TAG DEV O0D &LOCID &USERID 
DISK DUMP &FNAME &FTYPE &FMODE 
CP SPOOL OOD OFF 

CP TAG DEV O90D 


To send the file PLANXYZ SCRIPT to VM/370 CMS user SMITH on the BOSTON system, 
you Would invoke the SEND EXEC as: 


SEND BOSTON SMITH PLANXYZ SCRIPT 
The EXEC would execute as: 


SPOOL OOD TO NET 

TAG DEV 00D BOSTON SMITH 
DISK DUMP PLANXYZ SCRIPT 
SPOOL OOD OFF 

TAG DEV OOD 


The messages received from RSCS would be similar to those in the preceding 
example. In BOSTON, user SMITH would use the DISK LOAD command to move the 
file from his virtual reader to his A-disk. 


An EXEC for Sending a File to a Remote VM/370 User by Using a Nickname 


The SENDUSER EXEC uses the CMS editor to search through the distribution list 
file DISTRIB LIST for the nickname specified as the first operand. (If the 
DISTRIB LIST file is not found or the nickname is not found on that file, the 
EXEC issues an appropriate error message.) 


The distribution list matches the nickname with the formal location ID and 
user ID needed for RSCS to perform the transmission. This EXEC thus relieves 
you from remembering this data for each person to whom you are likely to send 
a file. You can identify each person by a nickname meaningful to you; each 
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nickname must be unique because the EXEC finds the first occurrence of that 
name in the DISTRIB LIST file and initiates transmission. 


If you use a nickname that iS an initial subset of another nickname, be sure 
to place the shorter name earlier in the DISTRIB LIST file. For example, 
place the nickname JOE ahead of the nickname JOEY; if the nickname JOE 
followed the nickname JOEY, the search for JOE would be satisfied when the 
EDIT FIND command found the first three characters in the nickname JOEY, and 
the file would be sent to JOEY, not JOE. 


An example invocation of this EXEC is: 
SENDUSER DICK PLANXYZ SCRIPT 
The SENDUSER EXEC code is: 


&CONTROL OFF 
&IF &INDEX EQ 1 &IF &1 EQ ? &GOTO —TELL 
&IF &INDEX LT 3 &GOTO -—TELL 
&IF &INDEX GT 4 &GOTO -TELL 
&ERROR &GOTO —NOLIST 
STATE DISTRIB LIST 
&ERROR &GOTO —NOFILE 
STATE &2 &3 &4 
&ERROR &EXIT 9 
CONWAIT 
&IF &READFLAG EQ STACK DESBUF 
&STACK HT 
&STACK FIND &1 
&STACK STACK 1 
&STACK QUIT 
EDIT DISTRIB LIST 
—-READ &IF &READFLAG EQ CONSOLE &GOTO —NOFIND 
&READ VARS &NAME &LOCID &USERID 
&STACK RT 
&ERROR &GOTO —RESET 
CP SPOOL PUNCH TO NET 
CP TAG DEV PUNCH &LOCID &USERID 
DISK DUMP &2 &3 &4& 
-RESET CP SPOOL PUNCH OFF 
CP TAG DEV PUNCH 
&EXIT 
-NOFIND &STACK RT 
&TYPE NAME &1 NOT FOUND IN FILE *°DISTRIB LIST’ 
&EXIT 99 
-NOLIST &TYPE FILE "DISTRIB LIST’® NOT FOUND 
&EXIT 999 
—-NOFILE &TYPE FILE &2 &3 &4& NOT FOUND 
&EXIT 9999 
—TELL &TYPE CORRECT FORM IS: &0 NAME FILENAME FILETYPE FILEMODE 
&SPACE 
&BEGTYPE 
WHERE: NAME IS A NICKNAME CUP TO 8 CHARACTERS) USED TO QUICKLY 
IDENTIFY THE USER TO WHOM YOU WISH TO SEND THE FILE 
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SENDUSER EXEC code (continued) ) 


DESCRIBED BY THE OTHER OPERANDS. FILEMODE IS OPTIONAL. 
NAME IS USED TO FIND THE LOCATION IDENTIFIER AND USERID 
FROM THE USER FILE "DISTRIB LIST’, WHICH IS A LIST OF 
NICKNAMES AND THEIR CORRESPONDING FORMAL LOCATION AND 
USER IDENTIFIERS, SUCH AS: 


JOHN BOSTON BJSMITH 
DICK NEWYORK DEPT24RW 
ETC. 


&END 


An EXEC for Sending a File to a List of Remote VM/370 Users 


_— Eee eel 


The SENDLIST EXEC sends a file to all the remote VM/370 users listed in a 
distribution list formatted like the one used by the preceding EXEC. You 
could maintain various distribution lists for different purposes. For 
example, if you send a report to a common set of recipients on a weekly basis, 
you could maintain a file called WEEKLY LIST and use it to send your report by 
invoking this EXEC, for example: 


SENDLIST WEEKLY MYREPORT SCRIPT 
An example invocation of this EXEC is: J 
The SENDLIST EXEC code is: 


&CONTROL OFF 

&IF &INDEX EQ 1 &IF &1 EQ ? &GOTO —TELL 
&IF &INDEX LT 3 &GOTO —TELL 
&IF &INDEX GT 4 &GOTO ~TELL 
&ERROR &GOTO ~—NOLIST 

STATE &1 LIST 

&ERROR &GOTO —NOFILE 

STATE &2 &3 &4 

&ERROR &EXIT 9 

CONWAIT 

&IF &READFLAG EQ STACK DESBUF 
&STACK HT 

&STACK I &LITERAL &BEGSTACK 
&STACK BOTTOM 

&STACK I &LITERAL &END 

&STACK FILE SBX EXEC A3 

EDIT &1 LIST 


&STACK RT 

EXEC SBX 

CP SPOOL PUNCH TO NET 

-READ &IF &READFLAG EQ CONSOLE &GOTO —END 

&READ VARS &NAME &LOCID &USERID J 


CP TAG DEV PUNCH &LOCID &USERID 
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SENDLIST EXEC code (continued) 


DISK DUMP &2 &3 &4 

&GOTO —READ 

-END CP SPOOL PUNCH OFF 

CP TAG DEV PUNCH 

&EXIT 

-NOLIST &TYPE DISTRIB. LIST FILE &1 LIST NOT FOUND 

&EXIT 999 

-NOFILE &TYPE FILE &2 &3 &4 NOT FOUND 

&EXIT 9999 

—-TELL &TYPE CORRECT FORM IS: &0 LISTNAME FILENAME FILETYPE FILEMODE 

&SPACE 

&BEGTYPE 

WHERE: LISTNAME IDENTIFIES THE DISTRIBUTION LIST YOU WISH TO USE 

TO TRANSMIT THE FILE DESCRIBED BY THE OTHER OPERANDS. 
FILEMODE IS OPTIONAL. THE FILE IDENTIFIED BY LISTNAME MUST 
HAVE THE FILETYPE OF ‘LIST*®. THE REQUIRED FORMAT OF THE 
DISTRIBUTION LIST FILE IS THE SAME AS THAT USED BY THE 
SENDUSER EXEC, WHICH IS NICKNAME, LOCATION, AND USER ID; 
FOR EXAMPLE: 


JOHN BOSTON BJSMITH 
DICK NEWYORK DEPT24RW 
ETC. 


&END 


RSCS JOB SUBMISSION TO AN MVS JES2/NJE BATCH PROCESSOR 


This example illustrates a CMS user (JONES) at location NEWYORK submitting a 
job to an MVS system running JES2/NJE in BUFFALO. Output returning from a 
batch job submitted through RSCS will be processed by the real unit record 
devices (printers and punches) attached to VM/370 unless overridden by the 
user’s JCL. 


User JONES wants a source deck assembled, link edited, and executed at BUFFALO 
and the resultant listing, object deck, and message data set returned to his 
virtual machine reader. The output from his program execution will be printed 
on the IBM 3800 Printing Subsystem at NEWYORK. 

He could use the following JCL: 


//EXAMPLE JOB 1, *JONES/926'°,CLASS=A 

/*JOBPARM LINES=1,CARDS=100,TIME=1 

J*NOTIFY NEWYORK.JONES 

/*ROUTE PRINT NEWYORK.JONES 

/*OUTPUT PRTA DEST=NEWYORK,COPIES=2,COPYG=2,CHARS=GT12 


/KXOUTPUT x FLASH=MEMO,FLASHC=1,MODIFY=INTU,FCB=FRM1 
/XOUTPUT PUNB DEST=(NEWYORK. JONES) 
1/8 EXEC PROC=ASMFCLG 


//ASM.SYSPRINT DD SYSOUT=A 
//ASM.SYSPUNCH DD SYSOUT=(B,,PUNB) 
//ASM.SYSIN DD x 
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Batch Processor JCL (continued) 


START CSECT 
END 
/* 
//GO.SYSPRINT DD SYSOUT=CA,,PRTA) 
// 


The NOTIFY control statement causes any JES2 messages produced by the batch 
system to be returned by the network to JONES’ terminal. The ROUTE control 
statement causes all printed output that iS not specifically routed via the 
OUTPUT statement to be directed to JONES’ virtual reader. The OUTPUT control 
statements provide specific routing for the object deck (SYSPUNCH) and program 
execution output (SYSPRINT) data sets. In the case of SYSPRINT, two copies 


are specified, With the copies being made internally in the 3800. The 
character arrangement table name specified is GT12. The first copy will be 
printed with a forms overlay name of MEMO. Modifications to the printed 


output Will be made by copy modification module INTU. Finally, vertical 
spacing Will be determined by forms control buffer FRM1. For details, the 
user should refer to OS/VS2 MVS JCL (GC28-0692). 


The following illustrates the terminal session for the job: 


tag dev pun buffalo job 
R; 


sp pun to net 
R; 


punch compile job (noh) 


PUN FILE 8921 TO NET COPY 001 NOHOLD 
R ; 
16:56:47 


MSG FROM NET : SENT FILE 8921 (8921) ON LINK BUFFALO 
TO BUFFALO JOB 


16:58:00 
MSG FROM NET : FROM BUFFALO: 16.57.55 JOB 8921 SHASP165 
EXAMPLE ENDED AT BUFFALO 


PRT FILE 8923 FROM NET COPY 001 NOHOLD 
16:58:02 - 
MSG FROM NET : FILE (8921) SPOOLED TO JONES == ORG 


BUFFALO (SYSTEM) 04/01/80 16:57:59 E.D.T. 


PUN FILE 8925 FROM NET COPY 001 NOHOLD 
16:58:05 
MSG FROM NET : FILE (8921) SPOOLED TO JONES ~— ORG 


BUFFALO (SYSTEM) 04/01/80 16:58:01 E.D.T. 
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RSCS JOB SUBMISSION TO A VSE/POWER BATCH PROCESSOR 


This example illustrates a CMS user at location NEWYORK submitting a job to a 
VSE/POWER system in BOSTON. Output returning from a batch job submitted 
through RSCS will be processed by the real unit record devices (printers and 
punches) attached to VM/370 unless overridden by the user's JCL. 


The user wants a source deck assembled at Boston and the resultant listing 
data sets returned to New York. He wants the object deck to be punched at the 
local unit record device in Boston. In this example, the RSCS system at New 
York is labeled REMOTE 1 and the VSE/POWER system at Boston is global remote 
ID 2. He could use the following jobstream: 


* $5 JOB RUNXYZ 

* $$ LST REMOTE=1 
* $$ PUN REMOTE=0 
// JOB RUNXYZ 

// EXEC XYZ 

/* 

/& 

x $$ EOJ 


VSE/POWER permits only numeric values of 1 to 200 (decimal) to be used to 
identify Work stations connected to it. These numeric identifiers are set 
when the VSE/POWER system is generated. The job submitter must know the 
numeric identifiers and include them in the LST and PUN statements as 
appropriate. The LST statement indicates that the job’s printed output is to 
be routed to system 1 (the VM/370 system). The PUN statement indicates that 
the job’s punched output is to be processed in Boston. 


The following illustrates the terminal session for the job: 


tag dev pu boston 
R; 


sp pu to net 
R; 


pun runxyz job (noh 
PUN FILE 6645 TO NET COPY 001 NOHOLD 
R; 


16:57:47 
MSG FROM NET : SENT FILE 6645 (6645) ON LINK 
BOSTON TO BOSTON SYSTEM 


Thus, as a CMS user on a VM/370 system, you have the ability to do the 
following to the output created by the execution of a job in a VSE/POWER 
system: 

Receive output back and have it printed or punched on the VM/370 system 


printer or punch. This is the default option. You are not required to 
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include LST and PUN statements. 


e Route output to a remote station linked to the VSE/POWER system. To do 
this, you must use either a LST card or a PUN card with REMOTE=(x,y), where 
x is the CPUID specified on the POWER macro for the VSE/POWER system and y 
is the ID of the remote station. 


e Route output to be printed on the VSE/POWER system printer or punch. To do 
this, you may use an LST card or a PUN card with REMOTE=0, Where 0 
specifies VSE/POWER system local unit record processing. 


In transmitting a job, RSCS does not alter your file in any respect. The job 
must be in the form required for execution in a VSE/POWER system. (For 
details, refer to the VSE/POWER Remote Job Entry User's Guide, SH12-5328.) 


Note: RSCS will not accept jobs from a remote VSE/POWER system for execution 
in a VM/370 virtual machine. 


RSCS OUTPUT TRANSMISSION USING SPECIAL FORMS 


This example illustrates sending spool output from a VM/370 system to a remote 
batch system that has special forms capability. This CMS user wants the 
output from his virtual printer directed to BUFFALO to be printed on white 
paper using a text (TN5) print train. The device address of his virtual 
printer is the customary OOF. NET is the userid of the local RSCS virtual 
machine. The following illustrates the user's console: 


sp e to net 
R; 


tag dev e buffalo system 50 f=white t=text 
R; 


print planxyz script 
PRINT FILE 0118 TO NET COPY 001 NOHOLD 
R; 


12:55:49 


MSG FROM NET : SENT FILE 0118 (0118) ON LINK 
BUFFALO TO BUFFALO SYSTEM 


RSCS JOB SUBMISSION TO A REMOTE NJE/NJI SYSTEM WITH SPECIAL OUTPUT PROCESSING 


This example illustrates a job running on an MVS JES2/NJE batch processor with 
the output to be printed at a VM/370 node using a specified output class. A 
one-character batch system forms specification determines the output class. 
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//EXAMPLE JOB 1,MSGLEVEL=1 


/KXOUTPUT 1234 DEST=MIAMI,F=R 
// STEP EXEC ASMFC 
//ASM.SYSPRINT DD SYSOUT=H(A,,1234) 
//ASM.SYSIN DD % 
TEST CSECT 

END 
/* 


When the job executes, the SYSPRINT data set is printed at node MIAMI via 
VM/370 output class R. 


RSCS OUTPUT TRANSMISSION TO AN IBM 3270 INFORMATION DISPLAY SYSTEM PRINTER 


This example illustrates sending spool output from a VM/370 system to a remote 
3270 Information Display System printer. This CMS user wants the output from 
his virtual printer directed to APL3286 at node NEWYORK. It is assumed that 
this printer has the Data Analysis—APL feature and that link APL3286 was 
started with either DA-TEXT or DA-APL specified in the PARM keyword of the 
START command. NET is the userid of the local RSCS virtual machine. The 
following illustrates the user's console: 


sp prt to net 
R; 


tag dev prt newyork ap13286 50 prt=apl 
R; 


print console listing 
PRINT FILE 0026 TO NET COPY 001 NOHOLD 
R 5 


12:21:02 
MSG FROM NET : SENT FILE 0026 (0026) ON LINK NEWYORK 
TO NEWYORK APL3228&6 


MANAGING A FILE REJECTED BY RSCS DUE TO AN INCORRECT ADDRESS 


SP SY Ee ee Gee eee 


RSCS rejects any file whose tag does not contain a destination address that 
matches an entry 1n the local RSCS route or link tables. RSCS returns the 
file to the virtual reader queue of the originating local virtual machine 
user, who must correct the file tag and resubmit it to RSCS. The following 
example with the RSCS virtual machine ID of "NET™ shows how this is done: 


1. Suppose you direct a print file to RSCS for transmission by issuing the TAG 
and SPOOL commands: 


TAG DEV OOE HOYSTON 
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SPOOL OOE TO NET 
But the destination address "HOYSTON” is incorrect. J 
z2. You issue a PRINT command for a file. 


3. VM/370 responds with the message "PRT FILE 6783 TO NET". The spoolid of 
the file is 6783. 


4. RSCS examines the file tag and finds no match for "HOYSTON” in its route 
and link tables. RSCS returns the file to your virtual machine reader. 


5. VM/370 issues a message to you "RDR FILE 6783 TRANSFERRED FROM NET. RSCS 
issues a message to you "MSG FROM NET: FILE 6783 REJECTED —— INVALID 
DESTINATION ADDRESS”. 

6. You must then correct the tag and resubmit the file. Correct the tag by 
issuing a TAG FILE command "TAG FILE 6783 HOUSTON”. Resubmit the file by 
issuing a TRANSFER command “TRANSFER 6783 TO NET". 


7- RSCS accepts the file and enqueues it on the link required to reach the 
destination "HOUSTON". 


Before sending other files, correct the tag for your virtual printer by 
reissuing the TAG DEV command with the correct location identifier "HOUSTON”™. 


EXAMPLES OF SMSG USE 


The following examples assume that the local RSCS virtual machine is 
identified as "NET™ and that "BOSTON” is the location identifier of the remote 
system of interest. Responses from the remote VM/370 system are the same type 
as you would get from the local VM/370 system, except that each line of the 
response is displayed as a message prefaced with "MSG FROM NET: FROM BOSTON:"”™. 


smsg net msg boston tcsmith i will send the required file soon 


Displaying (via CPQUERY) the Log of a Remote VM/370 System 


smsg net cmd boston cpq log 
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ce 
zs 
0 


Displaying (via CPQUERY) Names of Users Logged On a Remote VM/370 System 


C 


smsg net cmd boston cpq names 


Displaying ‘(via CPQUERY) the Status of a Particular User on a Remote VM/370 
System 


smsg net cmd boston cpq u tcsmith 


smsg net q sys links 
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User Messages 


here 15 a short description of the messages sent by RSCS to the virtual 
machine user'’s console. For a detailed description of each message see 
"Appendix B: RSCS Messages”. 


DMTAXM1011I FILE "*spoolid’ (*orgid’) ENQUEVED ON LINK *linkid’ 


The user file specified is accepted by RSCS and is ready for 
transmission. 


IMTAXM1O021I FILE *spoolid’® (*orgid*) PENDING FOR LINK ‘linkid’ 


The link specified has no tag slot available for the file. The 
file is held by RSCS and enqueued When space becomes available. 


PMTAXMIOSE FILE "spoolid’® C’orgid’) REJECTED —— INVALID DESTINATION ADDRESS 


The destination address in the tag did not match any entry in the 
local RSCS*s route table or link table. The file specified 15 
returned to the user if the origin is local, otherwise it is 
purged. 


DMTAXM10G1 FILE C*orgid’) SPOOLED TO *userid’® -=— ORG ‘*locid’(userid2) mm/dd/yy i 
hh:mm:ss 


A file has arrived from a remote location and is awaiting user 
disposition. The file originator is identified. 


DMTAXMIL10E FILE *spoolid’ REJECTED —-— INVALID DEVICE TYPE 


The file identified by ‘*spoolid’ has arrived at the RSCS virtual 
machine for transmission, but the file was produced on a virtual 
spool device that is not supported by RSCS. 


DMTAXM111I USER *userid’® NOT IN CP DIRECTORY -—-— FILE (*orgid’) SPOOLED TO 
SYSTEM 


The specified file was received by RSCS at the destination 
location, but it Was addressed to a userid not in that VM/370 
system's directory. 


DMTAXM112E FILE ‘spoolid’® C*orgid"’) REJECTED BY RSCS ACCOUNTING EXIT 
The file identified by ‘spoolid’® and origin ‘orgid’ has arrived at 
the RSCS virtual machine for transmission. The installation 


accounting exit has determined that the file should not be 
transmitted. 
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DMTxxx147I SENT FILE ‘spoolid’® ¢*orgid’) ON LINK ‘linkid’ TO tlocid’ ‘userid’ 
The specified file has been passed to the next node in the network. 

DMTxxx1l70I FROM ‘locid’: (message text) 

DMTxxxl71I FROM ‘locid’ (*userid'): (message text) 


These messages identify the source of the accompanying text on the 
user console. 


DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘'linkid’ =—— NO ACTION TAKEN 
A line driver-type RSCS command has been recognized for the link 
specified by ‘'linkid’. The command is invalid for the particular 


line driver that is controlling this link. 


DMTRPT9211I PRINTER ON LINK *linkid’® LINE ‘vaddr’ DISABLED -— INTERVENTION OR 
MAINTENANCE REQUIRED 


A printer described by ‘linkid’® and ‘'vaddr’* detected an I/O error 
condition while a file wWas printing. 


DMTRPT922I INTERVENTION REQUIRED ON PRINTER LINK ‘%linkid’ LINE ‘vaddr’ 


A printer described by "linkid’ and "vaddr’* needs operator 
intervention. 


DMTRPT92Z25I FILE PURGED BY USER ON PRINTER ‘'linkid’ LINE ‘vaddr’ 
On the printer described by ‘linkid’ and ‘vaddr', the user raised 
the cover three times (With the same print buffer), which caused 
the line driver to purge the file. 


DMTSML935E LINK ‘linkid IN RJE MODE -—-— PRINT FILE ‘spoolid’ PURGED 


The specified link iS Working as a submitting RJE workstation and 
Cannot accept print files. 


DMTNPT936E NO REMOTE PUNCH AVAILABLE ON LINK ‘linkid’* —-— FILE ‘spoolid’ PURGED 


The terminal specified cannot produce the user-specified punched 
output. 


DMTPOWSG4OE link "linkid’ IN POWER MODE — PRINT FILE ‘*spoolid’® PURGED 


When operating in this mode, print files cannot be transmitted. 
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Part 5: Appendixes 


Appendixes contain detailed descriptions 
of all commands and messages, plus 
reference information on communicating 
with remote stations and terminals. The 
appendixes are: 

A RSCS Commands 

B RSCS Messages 

C RSCS Networking User Exits 


D Nonprogrammable Remote Terminals 


E Programmable (Spool MULTI-LEAVING) 
Remote Stations 


F  VSE/POWER Remote System Connection 
G Base Tape Contents 


H Abbreviations 
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Appendix A: RSCS Commands 


Here is a detailed description of the RSCS commands, including the messages 
resulting from the use of each command. 


NOTATIONAL CONVENTIONS 


The notation used to define the command syntax in this manual is: 


3. 


Truncations and Abbreviations of Commands 


Where truncation of a command name is permitted, the shortest acceptable 
version of the command is represented by uppercase letters. (Remember, 
however, that RSCS commands may be entered with any combination of upper 
and lowercase letters.) For example, the format specification for the 
BACKSPAC command is: 


BAckSpac 


This representation means that BA, BAC, BACK, BACKS, BACKSP, BACKSPA, and 
BACKSPAC are all valid specifications for this command name, as are any 
of those combinations in which lower case characters are substituted for 
their upper case equivalents. 


Operands and options are specified in the same manner. Where truncation 
15 permitted, the shortest acceptable version of the operand or option is 
represented by uppercase letters in the command format box. If no 
minimum truncation is noted, the entire word (represented by all capital 
letters) must be entered. 


The following symbols define the command format and should never be typed 
wihen the actual command is entered. 


underscore = 
braces { } 
brackets [ ] 
ellipsis ee 


Uppercase letters and words, and the following symbols, should be entered 
as specified in the format box. 


asterisk 3% 
comma 
hyphen = 
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5A-2 


equal sign = 


parentheses ( ) 
period . , 


colon : 


Lowercase letters, words, and symbols in the command format box represent 
variables for which specific information should be substituted. For 
example, in the BACKSPAC command, linkid represents a variable link 
identifier, such as NEWYORK. 


Choices are represented in the command format boxes by stacking: 


w 


An underscore indicates an assumed (default) option. If an underscored 
choice is selected, it need not be specified when the command is entered. 
For example, 


Q fw yp 


indicates that A, B, or C may be selected. If B is selected, it need not | ) 
be specified. B is assumed if nothing is specified. 


The use of brackets denotes choices, one or more of which may be 
selected. For example, 


=< 
oO wr, 


indicates that you must specify A, and that you may specify either, both, 
or neither B or C. 


The use of braces with stacked options denotes choices, one of which must 
be selected. For example, 


indicates that you must specify either A, or B, or C. 
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C 


9. The use of brackets with stacked options denotes choices, one of which 
may be selected. For example, 


indicates that you may enter A, B, or C, or you may omit the field. 
10. An ellipsis indicates that the preceding item or group of items may be 
repeated more than once in succession. For example, 
Coptions ...) 


indicates that more than one option may be coded within the parentheses. 


OPERATOR COMMAND USAGE 


The commands described in this appendix can be issued by either the RSCS 
operator or the remote station operator, with the following exceptions: 


e CLOSE, CP, DEFINE, DELETE, DISCONN, EXEC, FORCE, REORDER, ROUTE, SHUTDOWN, 
TRACE, and TRANSFER commands may be executed only by the RSCS operator. 


¢ START has limited functional capabilities when issued by a remote station 
operator. (See the START command description.) 


e Commands issued by a remote station operator affect only the status of that 
station's link. With the exception of the MSG and the QUERY commands, the 
linkid operand must not be specified in a remote station command line. 


File attributes which are those of the VM/370 spool system, and the operands 

describing them in the RSCS command language, have maximum values and default 
values identical to those of the VM/370 command language and system. Command 
names and keywords may be specified by typing any part of the command name or 
keyword from the minimum truncation to the full name. The minimum truncation 
in each situation is indicated by upper case letters. 
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RSCS COMMANDS 
* (COMMENT > 


The * command enables the RSCS operator to annotate console listings. It 
performs no function, but is accepted by the RSCS command processor. It may 
be entered directly from the RSCS operator"’s console or from a command EXEC 
procedure. 


Responses: 


None. 


BACKSPAC 


BACKSPAC causes the current file being transmitted to be restarted or 
repositioned backward. This command is not supported by the DMTVMB, DMTVMC, 
DMTPOW, or DMTNJI line drivers. ) 


BAckspac [linkid] File 


AAA 


linkid is the one= to eight-character link identifier for the link on which 
the current file being transmitted is to be repositioned. If the 
command is issued by the RSCS operator, this operand must be 
specified; if issued from a remote station, it must be omitted. 


File specifies that the file being transmitted is to be restarted from 
the beginning. 


nnn is the number of data units to be backspaced. For a print file, 
data unit refers to printer pages, which are counted in the same way 
as for the analogous VM/370 spooling command. For a punch file, 
data unit refers to file records which include any write type 
command code. 


Responses: 


DMTxxx510I FILE *spoolid* BACKSPACED 
DMTxxx511E NO FILE ACTIVE ON LINK ‘linkid’ A 
DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘*linkid* —-— NO ACTION TAKEN 
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CHANGE 
CHANGE alters one or more attributes of an inactive spool file owned by the 
command originator. No link may be actively processing this file. 


ln [+t] | 


[linkid] spoolid (Coptions...)x NAme < dsname > 


[| | 


* At least one of the following 
options must be selected: 


PRIority nn ] 
CLass c ] 

COpy [x]nnn ] 
DIst distcode ] 
HOld|NOHold ] 
Flash name nnn ] 
MOdify name ] 
CHars name ] 

FCB name ] 

FOrm cccccccc J 


[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 


linkid is the one- to eight—character link identifier for the link on which 
the file to be changed is enqueuvued. If the command is issued by the 
RSCS operator, this operand must be specified; if issued from a 
remote station, it must be omitted. 


spoolid is the numeric spool file identifier for the file to be changed. 


PRIority nn 
designates the new transmission priority for the file. nnis a 
decimal number from 0-99 with 0 signifying the highest priority. 


CLass c designates the new class for the file. cis a one-character 
alphameric field from A to Z or from 0-9. 


COpy [*]nnn 
alters the number of copies to be made of the file. The value of 
nnn Cnumber of copies) must be a number from 1 through 255 (leading 
zeros are optional). The optional asterisk (%) can be specified on 
print files to be spooled to a 3800 printer to perform the file 
duplication internally one page at a time. This option prevents 
retransmission of the print file to the virtual output device every 
time a copy is desired. If RSCS is not running on the VM/System 
Product, the maximum value for nnn is 99. 


¢ DIst distcode 


changes the distribution code of the specified file. distcode is a 
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one— to eight—character identification to be associated with the 


file. ) 


HOld prevents the processing of the file until it is released by a CHANGE 
command specifying NOHOLD. 


NOHold releases the specified file if was in HOLD status. 


FLash name nnn 
signifies that a forms overlay contained in the 3800 printer be 
superimposed onto certain pages of the output. The name, one to 
four characters, identifies the forms overlay to be used in the 
projection. The maximum value of nnn (specifying that the first nnn 
pages of output are to be superimposed) is 255 when you are using a 
VM/SP host system, and 99 for all others (leading zeros are 
optional). The default, 0, indicates that no superimposing is 
desired. 


MOdify name 
aSS1igNS a copy modification module to be used when printing a file 
on the 3800. This function makes it possible to alter text either 
by preventing printing of certain information or by adding labels to 
output. The name must be one to four characters. If the name is 
omitted, the file prints normally without modification. 


CHars name 
specifies the character arrangement table used when printing a file. | 
The name must be from one to four characters. It determines Which J 
Writable character generation module (WCGM) is used for printing on 
the 3800. 


FCB name controls the vertical spacing of output on a page. The name must be 
from one to four characters. 


FOrm ccccccce 
specifies the one— to eight-—character form name or 1.D. for the 
file. This parameter is valid only when RSCS is running on the 
VM/System Product. 


NAme fn [ft] 

NAme dsname 
changes the name of the specified file. If specified, 
this operand must be the last entry in the command line. 


Note: The RSCS operator can nullify any previous or existing settings of the 
CHars, MOdify, FCB, or FOrm options by specifying 'NULL* in the name field of 
these operands. The Flash option can be nullified by specifying a count of 
zero, in which case the Flash name is meaningless. 


Responses: 


DMTAXM520I FILE *spoolid’ CHANGED 
DMTAXM521I FILE *spoolid’ HELD FOR LINK *linkid’ ) 
DMTAXM522I FILE *spoolid’® RELEASED FOR LINK ‘*linkid’ 
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DMT AXM5231 
DMT AXM524E 
DMT AXM525E 
DMT AXM526E 


CLOSE (FOR 


LINK *linkid’ QUEUE REORDERED 

FILE *spoolid’ ACTIVE —-—- NO ACTION TAKEN 

FILE *spoolid’® IS FOR LINK ‘'linkid’ -—— NO ACTION TAKEN 
FILE *spoolid’ NOT FOUND —— NO ACTION TAKEN 


RSCS OPERATOR ONLY) 


CLOSE deactivates one or more active files on an inactive link. Active input 


files are 


reenqueued as inactive files, and later retransmission begins at the 


start of each input file. Active output files (Which are normally incomplete) 


are discar 


ded. 


linkid ALL 
INput 
OUTput 
spoolid . 


Only one option may be entered. If no option is entered, a default 
of ALL 1 


linkid 


ALL 


INput 


OUTput 


spoolid .. 


Responses: 


DMT AXMSOOI 
DMTAXMS501E 
DMTAXM502E 


S assumed. 


is the one-— to eight-—character link identifier for the link on which 
the files to be closed are enqueued. The specified link must be 
inactive when CLOSE is issued. 


specifies that all active input and output files are to be 
deactivated. Active input files are deactivated and reenqueued. 
Active output files are deactivated and purged. 


specifies that all active input files for the specified link are to 
be deactivated and reenqueued. 


specifies that all active output files for the specified link are to 
be deactivated and purged. 


- specifies particular input file(s) to be deactivated and 
reenqueued. 


nn FILECS) CLOSED ON LINK ‘linkid’ 
LINK *linkid’ ACTIVE —-— NO FILE(S) CLOSED 
FILE *spoolid’® INACTIVE —-— NO ACTION TAKEN 
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CMD 


CMD passes a command to a remote system. The local RSCS system does not check 
the command for validity Cexcept as noted below); it simply sends the command 
to the remote system specified. 


CMD thus enables operators and users to execute query and control functions at 
remote systems. 


CMD is available to the virtual machine user via the CP SMSG command. Refer 
to "Part 4: VM/370 User's Guide™ for details. 


pH locid command text 


locid is the one- to eight-—character location identifier of the remote 
system to receive and execute the command text. 


command text 
is a string of up to 120 alphameric characters to be presented to 
the remote location as a system command. Format requirements for 
this string depend on the type of remote system implied by locid. 


The CMD command interface is extended for the VSE/POWER link to allow only the 
RSCS operator to forward the following VSE/POWER commands to the DOS/VSE node 
for execution: 


START 
Ss LST [,class(es)] 
STOP PUN 
P 
where: 
START or §S initiate a writer task in the VSE/POWER system for list or punch 
output. 
STOP or P terminates an active writer task in the VSE/POWER system. 
LST specifies a writer task for punched output. 
Class(es) is an optional parameter for specifying up to four output 


Classes for list or punch output. Classes may be specified as 
A-Z. If omitted, the default is class A. 


VSE/POWER commands may only be issued by the RSCS operator. For example: 
CMD POWER START LST,ABC 
All VSE/POWER commands will be checked for validity by DMTPOW before they are 


forwarded to the DOS/VS system. 


5A-8 IBM VM/370: RSCS Networking — Ref and Operations 


J 


‘ Responses: 


DMTxxx302E LINK "linkid’ IS NOT DEFINED 

DMTxxx303E LINK "linkid’ IS NOT ACTIVE 

DMTCMX310E LOCATION ‘locid’ IS NOT DEFINED 

DMTxxx320E LINK "linkid’ NOT CONNECTED 

DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK 'linkid’ -= NO ACTION 

| TAKEN 

DMTPOW941E LINK "linkid’ INVALID "CMD' SPECIFICATION 

DMTPOW942E LINK "linkid’ POWER COMMAND SPECIFIED INVALID OR NOT 
SUPPORTED 

DMTPOW943E LINK "linkid' POWER COMMAND OPERAND SPECIFIED INVALID OR 
NOT SUPPORTED 


CP (FOR RSCS OPERATOR ONLY) 


The CP command transmits commands to the VM/370 Control Program without 
leaving the RSCS command environment. 


| ce | commans text 


" command text is any CP command permitted for the command privilege of the RSCS 
virtual machine. The omission of this field will produce error 
message DMTCMX204E. 


Responses: 


None. (Response from CP may result.? 


CP QUERY 


When used within an RSCS CMD command, CPQUERY allows the RSCS operator to 
inquire about the status of a remote VM/370 system. 


CPQUERY 15 also available to any other virtual machine user via the CP SMSG 
command. Refer to "Part 4: VM/370 User's Guide™ for details. 


INDicate 
LOGmsg 

CPQuery < Names > 
Time 


( Users [userid] 
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INDicate displays the processor use, processor contention, main storage use, 


and main storage contention. | ) 
LOGmsg displays the log messages of the day. 
Names lists all the users logged on and the terminal device address to 


which each iS connected. If a user is disconnected, DSC is printed 
instead of the line address. 


Time displays the current real clock time in hours:minutes:seconds 
format, the time zone (for example, EST), the day of the week, the 
calendar date in month/day/year format, and the connect and 
processor time for the RSCS virtual machine. 


Users displays the number of users logged on and the number of users 
logically connected to other virtual machines. 


Users userid 
displays the user identification and the terminal device address of 
the specified user if that user is logged on. If that user is not 
logged on, a message to this effect is issued by CP. The response 
from this command is returned to the issuer via the CP message 
command. 


The CPQUERY command can be used in the command text operand of the CMD command 
in the following manner to obtain remote VM/370 system status information. 


Some examples are: 


SMSG rscsid CMD locid CPQ LOG , 
SMSG rscsid CMD locid CPQUERY NAMES 

SMSG rscsid CMD locid CPQ USERS 

SMSG rscsid CMD locid CPQUERY USER userid 
SMSG rscsid CMD locid CPQUERY INDICATE 
SMSG rscsid CMD locid CPQ TIME 


Responses: 


DMTCMX172I CPQ: (command response?) 


DEFINE (FOR RSCS OPERATOR ONLY) 


DEFINE causes a new link to be temporarily added to the set of valid links for 
the local RSCS, or causes an existing inactive link definition to be 
temporarily redefined. Permanent link definitions and changes can only be 
made by modifying the RSCS directory. Files addressed to the remote station 
Whose location ID is identical to the link ID may be processed after the link 
has been defined. Up to sixteen new links may be temporarily defined. 
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C 


DEFine 


linkid 


CLass c 


KEEP 


LINE 


TASK 


TYPE 


linkid Class c 
KEEP holdslot 
LINE vaddr 
TASK name 
TYPE driverid 
ZONE zoneid 


is the one- to eight-—character link identifier for the new link to 
be defined, or for the existing link to be redefined. 


specifies the classes of files Which may be processed by the active 
link. c can be either *, meaning all file classes may be processed, 
or from one to four classes (single characters with no intervening 
blanks). If no classes are specified, the default is x. 


holdslot 


vaddr 


name 


specifies the number of virtual storage file tag slots to be 
reserved for exclusive use by the link being defined. "holdslot™ is 
a decimal number from zero to sixteen. If the KEEP parameter is 
omitted, a default value of two is assumed. 


designates the virtual device address (vaddr) of a permanent 
telecommunications port to be used for processing files for the 
affected link. If this parameter is omitted, the LINE definition 
defaults to undefined. 


designates a task name for the line driver for the link. name is a 
one— to four-character alphameric identifier. If this parameter is 
omitted, the task definition defaults to undefined. 


driverid 


designates the kind of line driver for the link. driverid is a one- 
to eight-—character name of the line driver to be used (DMTSML, 
DMTPOW, DMTNPT, DMTRPT, DMTNJI, DMTVMB, or DMTVMC). The type of 
line driver for a link depends on the type of remote 
telecommunications system involved. (See "Line Driver Selection” in 
Part 2 of this manual.) If anew link is being defined and this 
operand is not specified, the type definition defaults to undefined. 


ZONE z2oneid 


specifies the number of time zone boundaries between the remote 
location and Greenwich to the east, the International Date Line 
being included as a time zone boundary. If the ZONE parameter is 
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omitted, a default of 0 (Greenwich Mean Time? is assumed. } 


Responses: 


DMTCMX540I NEW LINK ‘linkid’® DEFINED 

DMTCMX541I LINK "’linkid’ REDEFINED 

DMTCMX542E LINK "*linkid’ ACTIVE =— NOT REDEFINED 

DMTCMX543E LINK *linkid® NOT DEFINED —-—- LINK LIMIT REACHED 
DMTCMX653I LINK "’linkid’® DEFAULT ‘task’ ‘"’type’" ‘'vaddr’® c Z=z R=r 
DMTCMX206E INVALID OPTION ‘keyword’ ‘option’ 


DELETE (FOR RSCS OPERATOR ONLY) 


DELETE causes a previously defined link to become temporarily undefined. 
Permanent deletion of a link can only be made by deleting the entry from the 
RSCS directory. The link to be deleted must be inactive and must have no 
files, enqueued or pending when the DELETE command is issued. Files addressed 
to an undefined link are rejected as invalidly addressed. 


linkid is the one— to eight-character link identifier for the link to be 
undefined. 


Responses: 


DMTCMX550I LINK *linkid*® NOW DELETED 
DMTCMXS51E LINK ’linkid’ ACTIVE -— NOT DELETED 
DMTCMX552E LINK ‘linkid’ HAS A FILE QUEVE -- NOT DELETED 


DISCONN (FOR RSCS OPERATOR ONLY)? 


DISCONN disconnects the RSCS operator console from the VM/370 system while 
RSCS continues to operate. The RSCS DISCONN command operates like the VM/370 
DISCONN command, except that another userid may be specified to receive all 
RSCS operator’s console output lines. If no userid is specified, the RSCS 
console output lines are discarded without being printed. For the RSCS 
operator to reconnect his console, he must log on to the system again. 


Cee [ie 


userid is the one— to eight-—character ID for the virtual machine to receive J 
subsequent RSCS operator console output lines. 
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c 


ra 


Responses: 


DMTCMX560I RSCS NETWORKING DISCONNECTING 
DMTCMXS561E USERID "userid’ NOT RECEIVING 


DRAIN 


DRAIN deactivates the specified link after the file currently being processed 
is completed. The link is deactivated immediately if no file is being 
processed when the DRAIN command is issued. An inactive link is activated by 
a START command. If a START command is issued for the link before final file 
processing iS complete, the link is not deactivated and normal processing is 
continued. 


linkid is the one— to eight-character link identifier for the link to be 
deactivated. If the command is issued by the RSCS operator, this 
operand must be specified; if issued from a remote station, it must 
be omitted. 


Responses: 


DMTxxx570I LINK "linkid’ NOW SET TO DEACTIVATE 
DMTxxx571E LINK "linkid® ALREADY SET TO DEACTIVATE 


EXEC (FOR RSCS OPERATOR ONLY) 


EXEC executes a sequence of RSCS commands contained in a CMS file on the RSCS 
system disk. 


filename is the filename of a file containing one or more RSCS commands to be 
executed. The filetype of the file must be 'RSCS", and the file 
must contain fixed-length 80-character records. 


RSCS exec files may contain any valid RSCS command except another EXEC 
command. Each line of the exec file is interpreted as a single RSCS command 
line; no conditionals or substitution variables are permitted. 


At Initial Program Load, RSCS normally searches its system disk for a file 


named *PROFILE RSCS*, and executes the file as an exec file if it is found. 
This function may be suppressed by IPLing RSCS using the "NOPROF* parameter as 
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follows: 


Ipl vaddr PARM NOPROF 2 


Responses: 


DMTCMX675E EXEC ‘filename’ NOT FOUND ON DISK 'vaddr* —— COMMAND FILE NOT 
EXECUTED 

DMTCMX676E FATAL ERROR READING FROM ‘’vaddr’ —-— EXEC *filename’*® PROCESSING 
TERMINATED 

DMTCMX677E EXEC ‘filename’ FILE FORMAT INVALID —— EXEC NOT EXECUTED 

DMTCMX678E EXEC ‘filename’ IN EXECUTION —— NEW EXEC COMMAND IGNORED 

DMTREX679I EXECUTING ‘filename’ COMMAND: (command line?) 


FLUSH 


FLUSH halts processing of a file currently being transmitted on a link. The 
file is either purged or held, and link processing continues with the next 
file enqueued for transmission on the link. 


Note: This command is not supported by the DMTPOW line driver. 


[linkid] |spoolid » 


x 


linkid is the one- to eight-—character link identifier for the link on which 
the file to be flushed is being transmitted. If the command is 
issued by the RSCS operator, this operand must be specified; if 
issued from a remote station, it must be omitted. 


spoolid 1s the numeric spool file identifier for the file to be flushed. 
This field is provided to assure that an operator does not 
inadvertently destroy the wrong file through a timing error. 


* specifies that the file currently being transmitted is to be 
flushed. 


Note: This option is only available to the remote operator. 


ALL specifies that all copies of the file being transmitted are to be 
deleted. If this option is not specified, only the current copy is 
deleted and the next copy, if any, iS processed. 


HOld specifies that the file being transmitted is not to be purged, but 
rather is to be saved and placed in system hold status. Processing 
of the file may be restarted after the file has been taken out of 2 
hold status by a CHANGE command. 
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Responses: 


DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK *linkid* -— NO ACTION 
TAKEN 

DMTxxx530I FILE *‘spoolid’ PROCESSING TERMINATED 

DMTxxx581E FILE *spoolid’® NOT ACTIVE 


FORCE (FOR RSCS OPERATOR ONLY) 


FORCE immediately deactivates the specified link and terminates its line 
driver task. 


linkid is the one— to eight=—character link identifier of the link to be 
deactivated. 


FORCE should be used only when the DRAIN command fails to deactivate the link. 
Note that the DRAIN command allows files in active transmission to complete 
before deactivation of the link. 


Responses: 


DMTREXOO2I LINK ‘*linkid’® DEACTIVATED 


FREE 


FREE resumes file transmission for a particular link. The hold status for 
each of the files enqueued on the link is not affected. FREE has no effect on 
a link for which file transmission was not suspended by a HOLD command. 


linkid is the one- to eight-—character link identifier for the link on which 
file transmission is to be resumed. If the command is issued by the 
RSCS operator, this operand must be specified; if issued from a 
remote station, it must be omitted. 


Responses: 


DMTxxx590I LINK ‘'linkid®’ RESUMING FILE TRANSFER 
DMTxxx591E LINK *linkid’® NOT IN HOLD STATUS 
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FWDSP ACE 


FWDSPACE causes the file currently being transmitted to be repositioned 
forward. 


Note: This command is not supported by the DMTVMB, DMTVMC, DMTNJI, or DMTPOW 
line drivers. 


FWdspace [linkid] [nnn] 


linkid is the one— to eight—character link identifier of the link on which 
the file currently being transmitted is to be repositioned. If the 
command 1s issued by the RSCS operator, this operand must be 
specified; if issued from a remote station, it must be omitted. 


nnn is the number of data units to be forward spaced (if none is 
specified, a default of 1 1s assumed). For a print file, data unit 
refers to printer pages, which are counted in the same way as for 
the VM/370 BACKSPAC command. For a punch file, data unit refers to 
file records which include any write type command code. If nnn is 
greater than the number of data units remaining to be processed, 
FWDSPACE acts as a FLUSH command. 


Responses: 


DMTxxx511E NO FILE ACTIVE ON LINK ‘linkid’ 

DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK *linkid’® -—= NO ACTION 
TAKEN 

DMTxxx600I FILE "*Sspoolid® FORWARD SPACED 


HOLD 


HOLD temporarily suspends file transmission for a particular link, without 
deactivating the link. Transmission is suspended when the currently active 
file is completed, or, optionally, it may be suspended immediately, and later 
resumed from that point by a FREE command. The HOLD command does not affect 
the hold status of any file enqueued for transmission on the link. 


[wore «| tavnwva) farm 


linkid is the one- to eight=-character link identifier of the link for which 
file transmission is to be suspended. If the command is issued by 
the RSCS operator, this operand must be specified; if issued from a 
remote station, it must be omitted. 


IMMED specifies that active file transmission, if any, is to be suspended 
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immediately. 


Note: The IMMED operand is not supported by the DMTVMB, DMTVMC, 
DMTPOW, or DMTNJI line drivers. 


Responses: 


DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘%linkid’ —-— NO ACTION 
TAKEN 

DMTxxx610I LINK "*linkid’ TO SUSPEND FILE TRANSMISSION 

DMTxxx61l1I LINK "linkid’® FILE TRANSMISSION SUSPENDED 

DMTxxx612E LINK ‘linkid’ ALREADY IN HOLD STATUS 


HT 


HT suppresses the printing of any messages stacked for output to the RSCS 
operator console. HT has no effect on the execution of any other commands in 
progress or pending. If entered from a remote station console, HT purges any 
messages pending in that link's message stack. 


eee 


Responses: 


None. 


MSG 


MSG causes a line of arbitrary text to be forwarded to a remote station and 
presented to a user or operator as a message. When sending messages to a 
VSE/POWER system, use of MSG is restricted to the RSCS operator. 


MSG is available to the virtual machine user via the CP SMSG command. Refer 
to "Part 4: VM/370 User's Guide™ for details. 


[msgtext] 


locid is the one= to eight-—character location identifier of the location 
to receive the specified text line. If the message is for a local 
VM/370 user, this operand is specified as the local RSCS location 
ID. 
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userid is a one— to eight-character identifier of a user at that location. 
If the message is to be sent to a remote batch terminal, the userid 
field is ignored, but a dummy entry must be included to avoid 
deletion of the first word of the message text. 


RSCS specifies the remote RSCS operator's console. 


msgtext is an arbitrary string of up to 120 alphameric characters comprising 
the message to be sent. 


Responses: 


DMTxxx302E LINK *linkid’ IS NOT DEFINED 

DMTxxx303E LINK *linkid’ IS NOT ACTIVE 

DMTCMX310E LOCATION "*locid’ IS NOT DEFINED 

DMTxxx320E LINK "’linkid’ NOT CONNECTED 

DMTRGX330E USERID MISSING OR INVALID 

DMTRGX331E ‘userid’ NOT LOGGED ON 

DMTRGX332E ‘userid’ NOT RECEIVING 

DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘'linkid’ == NO ACTION 
TAKEN 


ORDER 


ORDER causes the file queue for a particular link to be reordered as 
specified. The effect of the command is to redefine the order in which 
particular files are to be processed on the link. The specified files are 
placed at the start of the link queue in the specified order, and the file 
priority attribute is automatically set to zero (top priority) for each 
specified file. 


[linkid] spoolidl [ spoolid2 ... ] 


linkid is the one- to eight-character link identifier for the link on which 
the file queue is to be reordered. If the command is issued by the 
RSCS operator, this operand must be specified; if issued from a 
remote station, it must be omitted. 


spoolidl specifies the affected file(s), and defines the new order 
has in which they are to be enqueued. 


Responses: 


DMTAXM523I LINK ‘linkid’ QUEUE REORDERED 

DMTAXM524E FILE *spoolid’ ACTIVE =— NO ACTION TAKEN 

DMTAXM525E FILE *spoolid’ IS FOR LINK "linkid’ -— NO ACTION TAKEN 
DMTAXM526E FILE "*spoolid’ NOT FOUND —~—= NO ACTION TAKEN 
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PURGE 


PURGE causes specified inactive files for a particular link to be removed from 
the system before they are processed on the link. Any file may be purged, 
regardless of its status, as long as it has not been selected for 
transmission. 


r 1 
[linkid] < ALL > 


spoolidl spoolid2 ... | 


linkid is the one- to eight—character link identifier for the link on which 
the files to be removed are enqueued. If the command is issued by 
the RSCS operator, this operand must be specified; if issued from a 
remote station, it must be omitted. 


ALL specifies that the entire queue of files for the link is to be 
removed from the system. 


spoolidl specifies the particular file(s)? to be removed from the 
tanta system. 


Responses: 


DMTAXM524E FILE "spoolid’ ACTIVE —-— NO ACTION TAKEN 
DMTAXM525E FILE "*spoolid’ IS FOR "linkid’ —-— NO ACTION TAKEN 
DMTAXM5S26E FILE ‘spoolid’ NOT FOUND —-— NO ACTION TAKEN 
DMTAXM640I 'nn' FILECS)? PURGED ON LINK ‘linkid’ 


QUERY 


QUERY displays linkid, file, or RSCS status information. If the command is 
issued by the RSCS operator, the response is sent to the RSCS operator's 
console. If the command is issued by a remote operator, the response is 
printed on the remote station printer. For the information returned by each 
option of the QUERY command, refer to the appropriate message text in 
"Appendix B: RSCS Messages”. 


QUERY is also available to any other virtual machine user via the CP SMSG 
command. Refer to "Part 4: VM/370 User's Guide™ for details. 
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Def | 
linkid < Files > 


| Active 


Queue 
sum 


File spoolid 


Active 
Links 
Ports 
Queue 
Routes 


Only one item: a linkid, a file, or the system, may be queried at any 
one time, and only one keyword may be specified. 


locid requests information pertaining to the active attributes and status 
of the link specified by the one- to eight—character locid. Status 
information includes activity status, type of line driver, line 
address, classes of files to be processed, HOLD status, DRAIN 
status, TRACE status, number of files in queue, and number of files 
Waiting to be queued. (See the descriptions of messages DMTCMX636I1, 
DMTCMX6371, DMTCMX651I1, and DMTCMXé521I.) 


linkid Active 

requests information pertaining to the active file descriptors for 
the link specified by the one- to eight-character linkid. Activity 
information includes the VM/370 spool file ID, originating VM/370 
spool file ID, destination location and user ID, spool file class, 
file transmission priority, number of file records left to transmit, 
and total records, of the file currently being transmitted. (See 
the descriptions of messages DMTCMX656I and DMTCMX6651I.) 


linkid Def 
requests information pertaining to the defined default attributes of 
the link specified by the one- to eight-character linkid. Default 
information includes task name, type of line driver, line address, 
Classes of files to be processed, time zone identifying digit, and 
number of virtual storage file tag slots reserved for the link. 
(See the description of message DMTCMX6531.) 


linkid Files 
requests information pertaining to the file status of the link 
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linkid Sum 


specified by the one— to eight-character linkid. File information 
includes the number of files being transmitted, the number of files 
being received, the number of files accepted and in the queue, and 
the number of files pending. (See the description of message 
DMTCMX6541.) 


linkid Queue 


requests a list of brief descriptions of each inactive file enqueued 
for transmission, in the current queue order, on the link specified 
by the one- to eight—character linkid. Queue information includes 
the number of files in the queue and the number waiting to be 
entered in queue. In addition, for each file currently in the 
queue, an additional response is issued containing the spool file 
identification number, origin location, destination location, 
destination user ID (Cif any), spool file class, current transmission 
priority, the number of records in the file, and the file hold 
status. (See the descriptions of messages DMTCMX654I1 and 
DMTCMX6551.) 


requests summary information about the transaction and error 
counters maintained by the line driver concerning activity on the 
communications adapter. (See the description of message 
DMTxxx1l49I. > 


File spoolid STAT 


requests certain information pertaining to the particular file 

specified by the numeric spoolid. Status information includes 

activity status and the linkid of the link on wWhich the file is 
queued or being transmitted. (See the descriptions of messages 
DMTCMX6601, DMTCMX661I1, and DMTCMX664E. >) 


File spool RSCS 


requests a description of the RSCS control related attributes and 
status of the file specified by spoolid. RSCS-related attributes 
include originating location and user ID, originating VM/370 spool 
ID, date and time of creation, time zone reference for time of day, 
and the destination location and user ID. (See the descriptions of 
messages DMTCMX662I and DMTCMX664E.) 


File spool VM 


requests a description of the VM/370 spool system related attributes 
of the file specified by spoolid. VM/370 spool-related attributes 
include transmission priority, spool file class, number of copies 
requested, HOLD status, distribution code, filename and type, and 
data set name. (See the descriptions of messages DMTCMX663I, 
DMTCMX664E, and DMTCMX6é661.) 


SYstem Active 


requests information pertaining only to active links. Active link 
information includes link identification, link status, line driver 
type, line address, and hold status, drain status, and trace status. 
(See the descriptions of messages DMTCMX670I, DMTCMX672I1, and 
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DMTCMX6731.) 


SY¥stem Links 
requests brief descriptions of each link currently defined in the 
system. Inactive link information includes link identification, 
activity status, default line driver type, and default line address. 
Active link information includes link identification, link status, 
line driver type, line address, and hold status, drain status, and 
trace status. (See the descriptions of messages DMTCMX670I1, 
DMTCMX6711, and DMTCMX6731.) 


SYstem Ports 
requests a brief description of entries in the switchable port 
table. Port information includes port availability status and 
identification of ports in use by link ID and port address. (See 
the descriptions of messages DMTCMX625I1, DMTCMX626I1, and 
DMTCMX6271.) 


SY¥stem Queue 
requests that message DMTCMX654I be issued for each link With a 
non=zero queued or pending file count. Queue information includes 
the number of files being transmitted and received, the files 
accepted and enqueued, and the files pending for each link ID With a 
non—zero queue. (See the descriptions of messages DMTCMX654I and 
DMTCMX6741.) 


J 
SY¥stem Routes J 


requests a brief description of entries in the routing table. Route 
descriptions show the link ID for each route definition in the RSCS 
routing table. (See the descriptions of messages DMTCMxX634I and 
DMTCMX6361.) 


Responses: 
QUERY ‘*’locid’: 


DMTCMX636I ‘locid’ ROUTED THROUGH LINK ‘linkid! 

DMTCMX6371 "locid’ NOT ROUTED 

DMTCMX6511 LINK 'linkid’ INACTIVE 

DMTCMX652I LINK 'linkid*? {CONNECT|ACTIVE} ‘task’ ‘type’ 'vaddr’ c 
{HO|NOH}{DR|NOD} {NOT|TRS|TRL|TSL} 


QUERY "*linkid’ ACTIVE: 
DMTCMX656I FILE "*spoolid’® (*’orgid’) ‘locid® ‘userid’ CL a PR pp 


LEFT mmmmmmmm OF nnnnannnn 
DMTCMX665I NO FILE ACTIVE 


QUERY "’linkid’® DEF: ) 


DMTCMX6531 LINK *linkid’ DEFAULT ‘task’ ‘type’ ‘vaddr’ c Z=z R=r 
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QUERY "linkid’ FILES: 


DMTCMX6541I LINK ‘linkid’ S=s R=r Q=q P=p 


QUERY "linkid’® QUEUE: 


DMTCMX6541I LINK 'linkid’ S=s R=r Q=q P=p 
DMTCMX655I FILE "spoolid’ (¢*’orgid'") ‘'locid’ "userid’ CL a PR pp 


REC niannnnnn {HO|NOH} 


QUERY "linkid’® SUM: 


DMTCMX1491 


QUERY FILE 


DMTCMX6601 


DMTCMX6611 


DMT CMX664E 


QUERY FILE 


DMTCMX662I1 


DMT CMX664E 


QUERY FILE 


DMT CMX6631 


DMT CMX664E 
DMTCMX6661 


LINK ‘*linkid’® LINE ACTIVITY; TOT=mmmmmmmm; 
ERRS=nnnnnnnn; TMOUTS=pppppppp 


*spoolid’ STAT: 


FILE "spoolid’ INACTIVE ON LINK ‘linkid’ 
FILE *spoolid’ ACTIVE ON LINK ‘linkid’ 
FILE *spoolid’ NOT FOUND 


*spoolid’ RSCS: 


FILE *spoolid’ ORG *locidl’ "useridl’ ORGID ‘'orgid’ 
mm/dd/yy hh:mm:ss zZ.z.z. TO ‘locid2’* ‘*userid2' 
FILE *spoolid’ NOT FOUND 


*spoolid’ VM: 


FILE *spoolid' PR pp CL a FO ffffffff CO [x]nnn {HO| NOH} 
DI "'distcode’, NA {'*fn ft" |] "*dsname’} 

FILE *spoolid’ NOT FOUND 

FILE *spoolid’ FL ffff FLC nn MO mmmm CH cccc FCB bbbb 


QUERY SYSTEM ACTIVE: 


DMTCMX6701 


DMT CMX6721 
DMT CMX673I 


LINK 'linkid' {CONNECT|ACTIVE} -- LINE ‘vaddr’ {HO|NOH} 
{DR|NOD} {NOT|TRS|TRL|TSL} 

NO LINK ACTIVE 

NO LINK DEFINED 


QUERY SYSTEM LINKS: 


DMTCMX6701 


DMT CMX6711I 
DMT CMX6731 


LINK "linkid’ {CONNECT|ACTIVE} -— LINE 'vaddr’? {HO|NOH} 
<DR|NOD> <NOT|TRS|TRL|TSL> 

LINK "linkid' INACTIVE 

NO LINK DEFINED 
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QUERY SYSTEM PORTS: 


DMTCMX625I NO PORTS AVAILABLE 
DMTCMX626I PORT ‘vaddr’ AVAILABLE 
DMTCMX627I PORT ‘vaddr’ IN USE BY LINK ‘linkid’ 


QUERY SYSTEM QUEUE: 


DMTCMX6541I LINK 'linkid’ S=s R=r Q=q P=p 
DMTCMX674I NO FILES QUEUED 


QUERY SYSTEM ROUTES: 


DMTCMX634I NO LOCATIONS ROUTED 
DMTCMX636I "*locid’ ROUTED THROUGH LINK ‘linkid’ 


REORDER (FOR RSCS OPERATOR ONLY) 


REORDER causes ail inactive files currently owned by the RSCS virtual machine 
to be reaccepted and routed. REORDER 1s not normally issued by the RSCS 
operator, but is issued internally by RSCS during processing of CLOSE, DEFINE, 
DELETE, ROUTE, or START commands, and following any link deactivation. 


Execution of this command will never adversely affect RSCS operations. 
However, in case of abnormal occurrences, files presented to RSCS might not be 
immediately accepted and transmitted automatically. REORDER forces RSCS to 
inspect its input files, and can initiate transmission of a “"hung™ file. 


Responses: 


DMTAXM109I FILE QUEUE REORDERED 


ROUTE (FOR RSCS OPERATOR ONLY) 


ROUTE defines, modifies, or deletes an entry in the RSCS routing table. RSCS 
uses its routing table to determine which link is to receive files, commands, 
and messages that cannot be transmitted to their destination location on a 
direct link. A direct link and an indirect route may be concurrently defined 
for the same remote location, using a single locid. In this case, indirect 
routing is used only when the indirect link is active and the direct link is 
not. Files are reenqueued following execution of a ROUTE command, so that 
transmission of rerouted files can begin immediately. 
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locid < TO linkid > 


[or | 


locid is the one- to eight-—character identifier for the remote location 
whose routing is to be modified. 


TO linkid specifies the link through which files, commands, and messages 
addressed to the specified remote location are to be routed. 


OFF cancels indirect routing for the specified locid. 


Responses: 


DMTCMX630I "locid’ NOW ROUTED THROUGH LINK ‘linkid’ 

DMTCMX631I INDIRECT ROUTING FOR "locid’ DEACTIVATED 

DMTCMX632E "locid’ INVALID ROUTE SPECIFIED 

DMTCMX633E "locid’ NOT ROUTED ~— ROUTE LIMIT REACHED 

DMTCMX6338E LOCATION "locid’ HAS A FILE QUEUE —— 
INDIRECT ROUTING NOT DEACTIVATED 


SHUTDOWN (FOR RSCS OPERATOR ONLY) 


SHUTDOWN effectively issues a DRAIN command to each currently active link. 
SHUTDOWN is the means for gracefully terminating RSCS operations. 


Responses: 


DMTxxx570I LINK "linkid’ NOW SET TO DEACTIVATE 
DMTxxx571E LINK "'linkid’ ALREADY SET TO DEACTIVATE 


START 


START, issued by the RSCS operator, can activate a specified inactive link. 
It can also be used by either the RSCS or remote operator to cause an active 
link to begin processing files of a specified set of classes or to reset a 
pending deactivation due to a DRAIN command. 
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linkid Class c ] [Parm ...] 
LINE vaddr ] 
TASK name ] 
TYPE driverid ] 


Any combination of keywords With associated options may be entered 
in any order, except that Parm keyword must be the rightmost keyword, 
if it is entered. 


linkid 


Class c 


LINE vaddr 


TASK name 


is the one= to eight—character link identifier for the inactive link 
to be activated, or for the active link on which file processing is 
to be altered. If START is issued by the RSCS operator, this 
operand must be specified; if issued from a remote station, it must 
be omitted. 


specifies classes of files which may be processed after execution of 
the command. c can be either *, meaning all file classes may be 
processed, or from one to four classes (single characters with no 
intervening blanks). If * is specified, no other classes may be 
specified. If multiple classes are specified for a link, files are 
processed in the order that the classes are specified, and in 
priority order within each particular class. If *® 1s specified, 
files are processed in priority sequence only. If no classes are 
specified, the definition of class in the link’s link table entry is 
used. 


designates the virtual device address (vaddr) of the line port to be 
used by the newly activated link. The value specified overrides a 
device address which may have been previously defined for the link. 
If no line port address is specified, the previously defined address 
is used. If no address was previously defined and no address is 
specified, an available switched port is selected for use, and the 
operator is informed of that selection. This keyword option is 
valid only When activating an inactive link. 


designates a task name for use by the line driver to be initialized, 
which overrides the name which may have been previously defined for 
the link. mame is a one— to four—-character alphameric identifier. 
If this field is not specified, the name previously defined for the 
link is used. If no name was previously defined for the link, an 
appropriate descriptive default task name is generated and used. 
This keyword option is valid only when activating an inactive link. 


TYPE driverid 


designates the name of the line driver to be used for the link to be 
activated. driverid is a one= to eight=—character name and must have 
been defined during RSCS generation. This keyword option is valid 
only when activating an inactive link. (See the topic "Line Driver 
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Parm 


Responses: 


DMTCMX7001 
DMTCMX701E 
DMTCMX702E 


DMTCMX703E 
DMTCMX704E 


DMTCMX705E 
DMT CMX706E 
DMTCMX707E 
DMTCMX708E 
DMT CMX709E 
DMTCMX710E 
DMTxxx750E 
DMTCMX751I 
DMTxxx752I 
DMTSMLYOILE 
DMTPOWSOSE 
DMTxxx906E 
DMTPOWSO8E 
DMTNIT9SLIE 
DMTNIT91ZE 
DMTNIT91SE 


DMTP OWS46E 


Selection” in Part 2 of this manual for determining which line 


driver to use for a given application.) 


overrides 
the link. 


Note: If 


This specification 
the driver name which may have been previously defined for 


no line driver type was previously defined for the link, 


this field must be specified. 


causes the remainder of the command line to the right of the Parm 
keyword to be made available to the newly activated line driver. No 
further interpretation is performed on the command line after a Parm 
keyword is encountered, so it must always be the rightmost keyword 


specified. 


For a description of the Parm operands for each line 


driver, see the sections on starting line drivers in Part 3 of this 


manual. 


ACTIVATING LINK ‘linkid’® ‘task’ "type’ ‘vaddr’ c 


NO SWITCHED LINE AVAILABLE == LINK ‘linkid’® NOT ACTIVATED 
LINE *‘vaddr’ IS IN USE BY LINK ‘linkidl’ —-— LINK ‘"linkid2’ 
NOT ACTIVATED 

DEV *cuu’ IS NOT A LINE PORT =-— LINK ‘'linkid’® NOT ACTIVATED 
LINE *‘vaddr* CC=3 NOT OPERATIONAL —-—= LINK ‘linkid’ 

NOT ACTIVATED 

DRIVER ‘type’ NOT FOUND ON DISK ‘'vaddr’ =~ LINK ‘linkid’ 
NOT ACTIVATED 

FATAL ERROR LOADING FROM ‘vaddr’* =—— LINK ‘linkid’® 

NOT ACTIVATED 

DRIVER ‘type*® FILE FORMAT INVALID -—— LINK "linkid’ 

NOT ACTIVATED 

VIRTUAL STORAGE CAPACITY EXCEEDED -—— LINK ‘linkid’ 

NOT ACTIVATED 

TASK NAME ‘'task*® ALREADY IN USE -—— LINK ‘linkid’ 

NOT ACTIVATED 

MAX C'nn*) ACTIVE -— LINK ‘linkid’ NOT ACTIVATED 

LINK "*linkid® ALREADY ACTIVE -= NO ACTION TAKEN 

LINK "linkid*® ALREADY ACTIVE -—— NEW CLASS(CES) SET AS REQUESTED 
LINK *linkid’® STILL ACTIVE -— DRAIN STATUS RESET 

INVALID SML MODE SPECIFIED -—= LINK ‘linkid’ NOT ACTIVATED 
PASSWORD SUPPLIED ON LINK ‘linkid’ IS INVALID 

INVALID BUFFER PARAMETER —=— LINK ‘%linkid’ NOT ACTIVATED 
INVALID *PARM’ PARAMETER ‘'parmvalue’ SPECIFIED 

INVALID NJI BUFFER SIZE SPECIFIED —— LINK ‘*linkid’ 

NOT ACTIVATED 

INVALID NJI NODAL RESISTANCE SPECIFIED —= LINK ‘linkid!' 
NOT ACTIVATED 

INVALID PASSWORD PARAMETER SPECIFIED =-— LINK ‘linkid’ 

NOT ACTIVATED 

INVALID POWER CPUID SPECIFIED —-— LINK ‘linkid’® NOT 
ACTIVATED 
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TRACE (FOR RSCS OPERATOR ONLY) 


TRACE enables the operator to verify that the line service is Working properly 
or to generate documentation useful in problem determination. 


TRACE causes the specified active link to start or stop reporting (on the 
operator's console) line activity summary information consisting of the number 
of successful transactions, unsuccessful transactions, and time-outs since the 
last similar message or since the link was activated. (See the description of 
message DMTxxx1491.) 


TRACE can also be used to start or stop logging of each line I/O transaction 
on a link. While log trace is active for a link, a record of each line I/0 
transaction is written to a spool print file. Each record contains the 
channel program executed, the composite CSW, the ending sense data if any, and 
the beginning and ending data string from each buffer used. The spool file is 
queued for real printer output when the log trace is deactivated for the link. 


linkid SUM 
NOSum 


If keywords are not entered, a default of SUM 1s assumed. 


linkid is the one— to eight-character link identifier of the link for which 
tracing is to be started or stopped. 


SUM specifies that the link’s line driver is to report all line activity 
in a standard format. 


NOSum specifies that the link’s line driver is to cease reporting line 
activity. This is the initial state at RSCS start—up. 


LOG starts the logging of I/0 activity on the link. 


'NOLog stops the logging of I/O activity and initiates the automatic 


printout of the log data. This is the initial state at RSCS 
start—up. 


Responses: 


DMTxxx149I LINK *linkid*® LINE ACTIVITY: TOT=mmmmmmmm; 
ERRS=nnnnnnnns; TMOUTS=pppppppp 

DMTxxx801I LINK "*linkid*® LOG ACTIVATED 

DMTxxx802I LINK ‘'linkid*® LOG DEACTIVATED 

DMTxxx803I LINK *linkid®’ SUM REPORTING DEACTIVATED 

DMTxxx81l0E LINK *°linkid’ LOG ALREADY ACTIVE 

DMTxxx81llE LINK "linkid’® LOG NOT ACTIVE 

DMTxxx812E LINK *linkid’® SUM REPORTING ALREADY ACTIVE 

DMTxxx813E LINK *linkid® SUM REPORTING NOT ACTIVE 
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TRANSFER (¢ 


TRANSFER r 


FOR RSCS OPERATOR ONLY) 


edirects inactive files specified by "spoolid’ to a new destination. 


RSCS removes the files from "linkid’ and enqueuves them on the link for the 
path to the new ‘locid’. 


TRANSfer linkid spoolidl [spoolid2 ...] TO locid [userid] 


linkid 


spoolidl 


locid 


userid 


Responses: 


DMT AXM524E 
DMT AXM525E 
DMT AXM526E 
DMT AXM6451 


is the one- to eight-—character link identifier of the link from 
which files are to be transferred. 


specifies the particular file(s) to be transferred from 
the specified link. 


is the one— to eight—character location identifier of the new 
destination for the files. 


is a one— to eight-character identifier specifying the new 
destination userid for the files. This userid defaults to "system' 
if it 1s not specified. 


FILE "spoolid’ ACTIVE -— NO ACTION TAKEN 

FILE *spoolid’ IS FOR LINK ‘linkid’ ~- NO ACTION TAKEN 
FILE *spoolid’ NOT FOUND —— NO ACTION TAKEN 

"nn* FILE(S) TRANSFERRED ON LINK ‘linkid’ 
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Appendix B: RSCS Messages 


Here is a detailed description of the RSCS messages and wait state codes. A 
message summary is included that groups the messages according to the type of 
operation in progress at the time of message generation. 


RSCS messages are issued in response to commands and spontaneously during 
system execution. Messages in response to commands are issued to the command 
originator and, in certain cases, to the RSCS local operator. Spontaneous 
messages are issued to the RSCS local operator whenever error or informational 
conditions arise during system operation. Certain spontaneous messages are 
issued to virtual machine users when they apply to files originated by or 
destined for the users. 


MESSAGE FORMAT 


The message identifiers conform to VM/370 standards. The first three 
characters (DMT) denote RSCS. The next three characters denote the module 
origin of each message; the possible codes are REX, RGX, CMX, CMY, AXM, INI, 
IRX, NPT, RPT, SML, VMB, VMC, NCM, NHD, and NIT. Some messages can be issued 
by more than one module. These messages appear in this appendix with the 
fourth, fifth, and sixth characters encoded as xxx. However, when the message 
is issued, xxx is replaced with the appropriate module code. The next three 
Characters contain the message number. The last character 15 a message 
severity code: 


Error message 

Informational message 

Response messsage 

Severe error message 

Termination of RSCS due to error 


43 n 2 eS Mm 


The message code (DMTAXM101I for example) is included in the message line if 
the ON option of the CP EMSG command is chosen. The time the message was 
generated (in the form hh:mm:ss) appears at the start of the message line. 


MESSAGE DESCRIPTIONS IN ORDER BY MESSAGE NUMBER 


ES = es 


DMTIRXOOOI RSCS NETWORKING VERSION vv, RELEASE nn, mm/dd/yy READY 


Explanation: This message signals the completion of RSCS 

initialization, including the activation of the AXS and LAX tasks. 
VERSION vv and RELEASE nn specify the Version and Release of RSCS 
in use. mm/yy/dd specifies the date on which the RSCS nucleus in 
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use Was generated. 


System Action: The system begins normal processing by accepting 
files and commands. 


Operator Action: Normally, activate one or more links. 


DMTCMXO001I FREE STORAGE = 'nn* PAGES 


Explanation: This message is issued automatically when the number 
of pages of unallocated virtual storage available to RSCS increases 
or decreases by a certain increment. The new number of available 
free pages is denoted by ‘nn’. 


System Action: Normal processing continues. 


Operator Action: This information helps the operator understand 
the state of RSCS processing. Knowledge of virtual storage 
utilization helps the operator decide whether to activate or 
deactivate links, and helps the system programmer decide an 
appropriate virtual storage size for the RSCS virtual machine. 


DMTREXOO2I LINK ‘linkid’ DEACTIVATED 


Explanation: The link identified by ‘linkid’ was deactivated as a 
result of the execution of a previous DRAIN or FORCE command, or as 
the result of a line driver terminal error. 


System Action: The link’s line driver task i5 deleted, all storage 
allocated to the task is made free, and the link table entry is 
updated. The link remains inactive until it 1S reactivated by a 
START command. 


Operator Action: If the link deactivation was spontaneous (that 
is, not as the result of a DRAIN command) restart the link using a 
START command. If spontaneous deactivations recur, notify local 
RSCS support personnel. 


DMTCMXO003I LINK "*linkid*® EXECUTING: (command line text) 
Explanation: The RSCS command described by (command line text) was 
forwarded by a directly connected remote station for local 
execution. The link identifier of the originating remote station 


is specified by ‘linkid’. 


System Action: The command is executed, and the resulting response 
is automatically returned to the originating remote station. 


Operator Action: None. 
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CC 


DMTCMX004I1 


DMTCMXOO5I 


DMT xxx070E 


LOCATION ‘’locid’® EXECUTING: (command line text) 


Explanation: The RSCS command described by (command line text) has 
been forwarded by the operator at a remote location for local 
execution. The location identifier for the originating remote 
location is identified by "locid’. 


System Action: The command is executed, and the resulting response 
is automatically returned to the originating remote operator. 


Operator Action: None. 


LOCATION ‘locid’(*’userid’) EXECUTING: (command line text) 


Explanation: The RSCS command described by (command line text) has 
been forwarded by an interactive user at a remote location for 
local execution. The command originator'’s location and user 
identifiers are specified by ‘locid’ and ‘userid’. 


System Action: The command is executed if it is a valid command 
for user execution, and the resulting response is automatically 
returned to the originating remote interactive user. 


Operator Action: None. 


I/O ERROR cuu SIOCC cc CSW csw SENSE sense CCW ccw 


Explanation: A message of this format is issued by any task in 
RSCS that detects an uncorrectable hardware or system error during 
an I/O operation. The causes of such an error vary, depending on 
the particular device type and command code. 


cuu - the virtual device address of the I/O device on which the 
error occurred. - 

cc - the condition code resulting from the issuing of the $10 
command on the device for the operation Which Was in 
error. 

CSW - the composite CSW associated with the operation in error. 


The composite CSW is a logical ORing of the CSW 
information associated with the SIO or the interrupts from 
the device While the I/0 operation was active. 

sense =— the sense information associated with the I/O operation in 
error if the 1/0 operation ends with unit check set on. 

ccw ~ the first CCW of the I/O operation in error if it failed 
to start, or the last CCW fetched by the channel before 
the I/O operation terminated with an error indication. 


System Action: The error is logged, and appropriate recovery 
procedures are taken. The exact effect of the I/O error condition 
depends on the conditions existing when it occurs. The system may 
continue processing normally, the link may be automatically 
deactivated, or RSCS may shut down. 
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DMTREXOSOE 


DMTREXOS90T 


DMTREXO91T 


Operator Action: This message may indicate a serious system or 
hardware error, or it may indicate common conditions such as 
intervention required. If the message is issued unexpectedly, 
notify local RSCS support personnel. 


PROGRAM CHECK -—— LINK ‘linkid’ DEACTIVATED 


Explanation: A program check interrupt occurred while the line 
driver for the link identified by "linkid’ was executing. There 
are no normal cases in Which this situation arises, and it probably 
reflects either a software or system generation error in either 
RSCS or CP. 


System Action: A dump of RSCS virtual storage is automatically 
taken and queued for real spool print output. The affected link is 
automatically deactivated. Normal RSCS operation for other links 
is not affected. 


Operator Action: Retrieve hard copy RSCS console output leading up 
to the program check, if possible, and attach it to the RSCS 
virtual dump when it has printed. Submit the dump and the console 
output to local RSCS support personnel. 


PROGRAM CHECK IN SUPERVISOR -—— RSCS NETWORKING SHUTDOWN 


Explanation: <A program check interrupt has occurred during the 
execution of MSUP, the RSCS supervisor, or during execution of one 
of the RSCS system control tasks, REX, AXS, or LAX. There are no 
normal cases in which this situation arises, and it probably 
reflects either a software or system generation error in either 
RSCS or CP. 


System Action: A dump of RSCS virtual storage is automatically 
taken and queued for real spool print output. Messages queued for 
operator output are written to the operator console, and RSCS 
terminates by loading a masked off wait state PSW with wait state 
code X‘'001’. 


Operator Action: When this situation arises immediately following 
RSCS IPL, retrieve hard copy RSCS console output leading up to the 
program check, if possible, and attach it to the RSCS virtual dump 
when it has printed. Submit the dump and the console output to 
local RSCS support personnel. Re-IPL RSCS and restart and 
reconnect the dialable links. 


INITIALIZATION FAILURE —— RSCS NETWORKING SHUTDOWN 


Explanation: An unrecoverable error occurred during the initial 
loading of the supervisor components, MSUP, REX, AXS, and LAX. 
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System Action: A virtual storage dump is automatically taken, and 
a masked off wait state PSW is loaded, terminating system 
operation. 


Operator Action: Retrieve hard copy RSCS operator console output, 
if possible, attach it to the RSCS storage dump after it has been 

printed, and submit it to local RSCS support personnel. Retry the 
RSCS IPL. 


DMTAXM101I FILE "*spoolid’ ('*orgid') ENQUEVUED ON LINK ‘linkid’ 


Explanation: ThisS message is issued when the file identified by 
"spoolid’, origin spoolid ‘orgid'’, has arrived at the RSCS virtual 
machine, and has been successfully accepted and enqueued on the 
link identified by "*linkid’. This message is also issued when a 
previously pending file is accepted after a tag slot has become 
available. 


System Action: The newly accepted file iS made available to the 
link's line driver for future transmission. If the line driver is 
Waiting for a file to transmit, it is notified that the new file is 
available. 


Operator Action: None. 


DMTAXM102I FILE ‘"*spoolid’® (*orgid’) PENDING FOR LINK ‘linkid’ 


Explanation: The file identified by "Spoolid’, origin spoolid 
"orgid’, has arrived at the RSCS virtual machine, but has not been 
enqueuved on the link ‘linkid’ to which it is addressed, because no 
tag slot is available. 


System Action: The link'’s pending count is incremented, and the 
file will be automatically accepted when a tag slot becomes 
available. 


Operator Action: If RSCS repeatedly exhausts its available tag 
Slots in normal operation, generate more extra tag slots by using 
the "TAGS" directory control statement, or by increasing the RSCS 
virtual machine's virtual storage size. 


DMTAXM1O03E FILE "spoolid’ (*orgid'>) REJECTED -—— INVALID DESTINATION ADDRESS 


Explanation: The file identified by "*spoolid’ origin spoolid 
*orgid” has arrived at the RSCS virtual machine bearing a 
destination address which is invalid, or which specifies a location 
ID that is not defined in the local RSCS as either a link or an 
indirect route. 
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System Action: If the file originated from a local VM/370 user, it 
is transferred back to the originator along with this message. If 
the file originated at a remote location, it is purged and this 
message is sent to the originator. 


User Action: If the file is transferred back from RSCS, correct 
the tag on the file to be transmitted by using the VM/370 TAG FILE 
*spoolid’ command to reflect a correct destination; then transfer 
the file back to the RSCS virtual machine by using the TRANSFER 
*spoolid’ TO "vmid* command. If the file is purged because it 
arrives at a location Which does not have the destination location 
ID defined, report the situation to local RSCS support personnel. 


DMTAXM104I1 FILE (*orgid’) SPOOLED TO ‘useridl’ -—— ORG "locid’ (*userid2’) 
mm/dd/yy hh:mm:ss 


Explanation: A file has been received from a remote location, 
acknowledged, written to the VM/370 spool system, closed, and 
spooled to the local virtual machine to which the file was 
addressed. 


orgid - the originating VM/370 spool ID, or the origin job 
number, of the file. 

useridl —-— the ID of the local virtual machine to which the file 
has been spooled. 

locid ~- the location identifier of the file’s originator. 


userid2 —-— the name of the file originator'’s system or device at 

the remote location. 

the date of the file’s origination at the remote 

location. 

hh:mm:ss — the time of day of the file’s origination at the remote 
location. 


J 


mm/dd/yy 


Cr. a 


System Action: The virtual output device used to process the file 
is detached and normal processing continues. 


Operator Action: None. 


DMTAXM105I FILE *spoolid’ PURGED 


Explanation: The file identified by "spoolid’ has been purged from 
the system as a result of normal processing. 


System Action: The file’s virtual storage tag is dequeued and its 


Slot is freed. If another file is pending, it is accepted. All 
system tables are updated, and normal processing continues. 


Operator Action: None. 
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DMT AXM1 061 


DMT AXM1071 


DMTxxx1l08E 


DMTAXM1 091 


FILE "spoolid’ MISSING -—— DEQUEUVED FROM LINK ‘linkid’ 


Explanation: The file identified by "spoolid' could not be located 
in the RSCS virtual machine spool input file queue during an 
attempt to open the file for the link identified by 'linkid’. This 
Situation can arise when a user retrieves a file from the the RSCS 
spool queue using the VM/370 "TRANSFER '"spoolid’ FROM 'vmid'"™ 
command. 


System Action: The file’s virtual storage tag is dequeued and its 
slot is freed. If another file iS pending, it is accepted. The 
link table entry is updated, and normal processing continues. 


Operator Action: No action iS necessary. This message does not 
indicate an error condition. 


"nhn’ PENDING FILES FOR LINK ‘linkid’ MISSING 


Explanation: A number ('nn*') of pending files for the link 
identified by ‘linkid' have been found to be missing from the RSCS 
virtual machine spool input queue during an attempt to accept a 
pending file. This situation can arise when a user retrieves a 
file from the RSCS spool queue using the VM/370 "TRANSFER ‘spoolid' 
FROM *vmid'" command. 


System Action: The link table entry is updated to reflect the 
proper pending file status, and normal processing continues. 


Operator Action: No action is necessary. This message does not 
indicate an error condition. 


SYSTEM ERROR READING SPOOL FILE ‘spoolid’ 


Explanation: A return code reflecting a VM/370 system error has 
been received in response to a read to the file identified by 
"spoolid’. 


System Action: The error is logged, the identified file is purged 
or placed in a HOLD status (depending on the affected line driver), 
and link processing continues. 


Operator Action: This message indicates a VM/370 system error. 
Notify local system support personnel. 


FILE QUEUE REORDERED 


Explanation: As the result of an RSCS CLOSE, DEFINE, DELETE, 
REORDER, ROUTE, or START command, or as the result of a link 
deactivation, the inactive file queue has been reordered to reflect 
the updated status of RSCS. 
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System Action: Each file enqueued by RSCS is reexamined and, if 
appropriate, rerouted in light of changed system status. 


Operator Action: None 


DMTAXM110E FILE "*spoolid’ REJECTED -— INVALID DEVICE TYPE 


Explanation: The file identified by "spoolid’ has arrived at the 
RSCS virtual machine for transmission. The AXS task has determined 
that the file was produced on a virtual spool device that is not 
Supported by RSCS. Valid spool device types are PRT, 1403, 3211, 
3203, 3289E, 3262, 1443, PUN, 2540P, and 3525. 


System Action: The file is transferred back to the originator 
along with this message. 


User Action: If possible, redefine the spool device that produced 
the file and resend the file to RSCS. 


DMTAXM1111I USER ‘userid’ NOT IN CP DIRECTORY —-—- FILE (*orgid’) SPOOLED TO 
SYSTEM 


Explanation: A file received by RSCS was addressed to a local user 
Tuserid’ which is not in the local VM/370 system directory. The 
file had an origin spool ID of ‘'orgid’. 


System Action: The received file 15 spooled to a real unit record 
device at the receiving location. 


Operator Action: None. 


DMTAXM112E FILE "*spoolid’® (*orgid’) REJECTED BY RSCS ACCOUNTING EXIT 


Explanation: The file identified by "spoolid’ origin spoolid 
"orgid’ has arrived at the RSCS virtual machine for transmission. 
The installation accounting exit has determined that the file 
Should not be transmitted. 


System Action: If the file originated from a local VM/370 user, it 
is transferred back to the originator along with this message. If 
the file originated at a remote location, it is purged and this 
message is sent to the originator. 


User Action: Check your local installation operating procedures to 
determine what factors are considered for rejecting a file and 
alter the file if possible. For example, the local installation 
may restrict file transmission from certain classes of users or 
files which are larger than some predetermined size. 
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DMT xxx141I 


DMT xxx142I 


DMT x«xx143I1 


LINE *vaddr’ READY FOR CONNECTION TO LINK *linkid' 


Explanation: This message is issued by a line driver to inform the 
operator that the line identified by ‘vaddr* is being enabled for 
communications processing to the link identified by "linkid'. 
Normally, this is the first message issued by a line driver after 
link activation, and it may be issued during active processing 
after a line becomes disconnected. 


System Action: The line driver begins an enable operation on the 
line and waits for completion, signalling a completed connection. 
If the line identified by ‘'vaddr’ is a non-switchable line, the 
connection completes automatically when the telecommunications 
hardware iS properly configured and functional. Normal RSCS 
processing continues. 


Operator Action: No response is needed if the line identified by 
"vaddr' is a non-switchable line, or if it is a Switchable line 
With auto-answer and the remote station is to complete the 
connection. If the line is a switchable line, complete the 
connection to the location identified by ‘"linkid’ (typically, dial 
and establish the connection). 


LINK "linkid" LINE ‘vaddr’* DATASET READY 


Explanation: This message signals completion of the line 
connection for the link identified by ‘linkid’ on the line port 
address identified by ‘vaddr’. This message is issued 
automatically when a non—-swWitchable line is enabled, and it is 
issued when a connection iS completed for a Switchable line. This 
message does not necessarily indicate that any successful 
interaction with the remote station has taken place on the 
connected line. 


System Action: Normal exchange of files, commands, and messages 
automatically begins if the telecommunication hardware and remote 
system are properly initialized and functioning correctly. 


Operator Action: None. 


LINK *linkid’ LINE *vaddr’ DISABLED 


Explanation: The virtual line port address identified by 'vaddr’ 
and associated with the active link identified by "linkid’ is now 
disconnected, having been connected prior to the message. This may 
be the result either of an apparent line disconnection due to line 
errors, or of a remote station disconnection, or of the execution 
of a disabling sequence by the local line driver during link 
deactivation. 
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DMT xxx144I 


DMT xxx145I 


DMT xxx146I1 


system Action: If the link is not in the process of deactivating, 

the line driver will automatically attempt to reestablish the line 

connection. Exchange of files, commands, and messages is suspended 
until the line reconnection is completed. 


Operator Action: If the link is not being deactivated, perform 
installation procedures for reconnecting the line. 


RECEIVING FILE (*orgid') ON LINK ‘linkid* FROM ‘locid’ ‘userid’, 
REC nnannnnnn 


Explanation: This message indicates that reception of a new file 
from the remote location identified by ‘locid’® and user at that 
location identified by ‘userid’ (if any) has begun. The file being 
received has an origin spoolid indicated by ‘orgid’ and contains 
the number of records indicated by 'nnnnnnnn’. 


System Action: File processing continues, and the new file is 
written to the VM/370 spool system as it is received. 


Operator Action: None. 


RECEIVED FILE (*orgid') ON LINK ‘*linkid’ TO ‘locid’® ‘userid’ 


Explanation: A new file has been completely received and 
acknowledged on the link identified by ‘linkid’. The originating 
spoolid or job number of the new file is identified by ‘orgid’. 
The file received is addressed to the location identified by 
"locid’ and the to the user at that location identified by 
"userid’. 


System Action: If the file is addressed to the local location, it 
is spooled to the receiving user or queued for real output. If the 
file is addressed to another location, it 1s enqueued for 
transmission on the next link of its path. Normal link processing 
continues. 


Operator Action: None. 


SENDING FILE *spoolid’ (’orgid’) ON LINK ‘linkid*® FROM ‘locid’ 
Yuserid’, REC nnannnannn 


Explanation: This message indicates that transmission of a file 
from the remote location identified by "locid’ and user at that 
location identified by ‘userid’ (Cif any) has begun. The file being 
transmitted has an origin spoolid indicated by ‘orgid’ and contains 
the number of records indicated by ’nnnnnnnn'. The identified file 
has become active. 
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DMT xxx147I 


DMT xxx148I 


DMT xxx149I 


System Action: Transmission of the file will normally continue to 
completion. If the file transmission is interrupted by a system 
failure or telecommunication hardware failure, the file will be 
retained and retransmitted, either from the point of interruption 
or from the beginning, depending on variable system characteristics 
and error conditions. 


Operator Action: None. 


SENT FILE ‘spoolid’® (C*orgid’) ON LINK ‘linkid’ TO ‘locid’ ‘userid’ 


Explanation: Transmission of the active file identified by 
*spoolid’ on the link identified by "linkid’ has been successfully 
completed and acknowledged by the remote station. The file is 
addressed to the location identified by ‘locid’, and to the.user 
identified by ‘userid’ at that location. The file’s originating 
spoolid or job number is identified by ‘orgid’. 


System Action: Disposition of the identified file follows, 
according to the status of the file. Normally the file would be 
purged, unless multiple copies of the file are being sent to a 
remote terminal. Normal link processing continues. 


Operator Action: None. 


ACTIVE FILE ‘*spoolid’ SENDING RESUMED ON LINK ‘linkid’ 


Explanation: Transmission of the file identified by ‘spoolid’ on 
the link identified by "linkid" has been resumed from the point at 
which transmission had previously been interrupted. File 
transmission may have been interrupted as the result of a 
telecommunication hardware failure, an unexpected terminal error in 
the link’s line driver, a remote system failure, or entry of the 
link into immediate hold status. 


System Action: Normal link processing continues. 


Operator Action: None. 


LINK "linkid’® LINE ACTIVITY: TOT= mmmmmmmm; ERRS= nnnnnvannn; TMOUTS= 
PPPPPPPP 


Explanation: This message is issued in response to a QUERY 
"linkid’ SUM command or a TRACE *linkid’* SUM command, and 
occasionally thereafter while trace sum mode is in effect for the 
specified link. The message is reissued when any one of the trace 
values reaches its incremental threshold, normally 20. 


mmmmmmmm — the total number of successful transactions that have 
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taken place on the identified link since the last 
similar message Was issued, or since the link was 
initially activated. 

nnnnnnnn =— the total number of transactions that have ended in 
error since the last similar message was issued, or 
since the link was initially activated. 

Pppppppp —- the total number of time-outs that have occurred while 
Waiting for response from the remote station since the 
last similar message was issued, or since the link was 
initially activated. 


System Action: Normal RSCS processing continues. 


Operator Action: The trace function provides information 
concerning communications on the link, for use in diagnosing and 
correcting problems with communication hardware. If the trace 
information seems to indicate serious malfunctioning, take 
corrective action such as dropping and redialing a switchable 
telecommunication port, deactivating and restarting a link using a 
different port, or reporting the difficulty to support and 
maintenance personnel. 


LINE *vaddr’ DISABLED FOR LINK ‘linkid’ 


Explanation: Communication on the link identified by "linkid’® via 
the line identified by ’vaddr’ has been terminated, and the line 
has been disabled. If the line iS a switchable line, then the line 
has been disconnected. 


This message may be issued during normal processing as a result of 
a spontaneous line disconnection. It is alwWays issued during link 
deactivation. 


System Action: If link deactivation is in process, it continues 
normally. Otherwise, the line driver will reinitialize and 
reenable the line, allowing a switchable line to be redialed. File 
processing for the link is suspended. 


Operator Action: None. 


FROM *locid’: (message text) 


Explanation: The character string included in the message as 
(message text) has been received from the remote location 
identified by "locid’*, and is addressed to the recipient. The 
message originated either from automatic remote system processing, 
or from the remote RSCS operator. 


System Action: Normal RSCS processing continues. 
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DMTCMX1721 


DMTxxx1l90E 


DMTCMX2001 


Operator Action: If the message originated from a remote RSCS 
operator and you Wish to respond, address the response message as: 
MSG "locid’ RSCS (response message text). 


FROM "'locid'("userid"): (message text) 

Explanation: The character string included in the message as 
(message text) has been received from a user identified by "userid’ 
at the location identified by "*locid’, and is addressed to the 
message recipient. The special keyword RSCS appears as the ‘userid’ 
field when the message origin is RSCS operator console. 


System Action: Normal RSCS processing continues. 


Operator Action: None. 


CPQ: (command response) 


Explanation: The character string included in the message as 
(command response) has been received from a remote location and is 
addressed to the recipient. The message was generated as the 
result of a CPQUERY command execution. 


System Action: Normal RSCS processing continues. 


Operator Action: None. 


INVALID SPOOL BLOCK FORMAT ON FILE ‘"spoolid’ 


Explanation:  VM/370 spool control or data information contained in 
the file identified by ‘spoolid’ has been found to be in error at 
the local installation. 


System Action: The error is logged, the identified file is purged 
or placed in a HOLD status (depending on the affected line driver), 
and link processing continues. 


Operator Action: Notify local VM/370 system support personnel of 
this error. 
RSCS NETWORKING 


Explanation: This message iS issued in response to a null line 
entered as an RSCS command. A null line contains no characters. 


System Action: If a command entered from an RSCS operator's 
console contains no characters as the result of console input line 
editing, this message is not issued and another console read is 
Started. Normal RSCS processing continues. 
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Operator Action: None. 


DMTCMX201E INVALID COMMAND *command' 
Explanation: The character string identified by "*command’ was 
entered as an RSCS command. The command either is prohibited for 


use by the command originator, or is not a defined RSCS command. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command if it was incorrect. 


DMTxxx202E INVALID LINK ‘*linkid’ 


Explanation: The character string identified by "linkid’" was 
entered as an RSCS link ID in a console command input string, and 
it does not conform to syntactical requirements for RSCS link IDs. 
CIt is not one to eight alphanumeric characters.) 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command if it Was incorrect. 


DMTxxx203E INVALID SPOOL ID 'spoolid’ 


Explanation: The character string identified by "spoolid’ was 
entered as a spool file ID in a console command input string, and 
it does not conform to syntactical requirements for VM/370 spool 
file IDs Cone to four decimal digits, 1-9900). 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command if it was incorrect. 


DMTxxx20GE INVALID KEYWORD 'keyword' 


Explanation: The character string identified by "keyword’ was 
entered as a keyword in a console command input string, and it is 
net a valid keyword for the command issued. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Consult RSCS command documentation to determine 


command syntax and restrictions. Retry the command if it was 
incorrect. 
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DMTxxx205E CONFLICTING KEYWORD "keyword’ 


c Explanation: The keyword identified by "keyword’ was used in the 
preceding command in an invalid Way. The keyword may have been 
entered more than once in the same command line, or the keyword may 
be invalid because another mutually exclusive keyword was entered 
in the same command. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Consult RSCS command documentation to determine 
command syntax and restrictions. Retry the command if it was 
incorrect. 


DMTxxx206E INVALID OPTION ‘"keyword’ ‘option’ 


Explanation: The combination of a keyword and its option 
identified by "'keyword’ ‘option’ was entered in a console command 
line, and it is not a valid combination for the command issued. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Consult RSCS command documentation to determine 
command syntax and restrictions. Retry the command if it was 


ne incorrect. 


DMTCMX207E CONFLICTING OPTION ‘keyword’ ‘option’ 


Explanation: The combination of a keyword and its option 
identified by "keyword’ "option" was used in the preceding command 
in an invalid way. The presence of another keyword or 
keyword—and-option combination in the same command may preclude 
specification of the identified keyword-and—-option combination. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Consult RSCS command documentation to determine 
command syntax and restrictions. Retry the command if it was 
incorrect. 


DMTCMX208E INVALID USER ID ‘userid’ 


Explanation: The operand identified by ‘userid’ was entered in an 
RSCS command as an interactive user ID, and is invalid as such. 
Valid interactive user IDs contain one to eight nonblank valid 
EBCDIC characters. 
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DMT CMX209E 


DMTCMX210E 


DMT xxx3001 


DMT xxx301E 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command if it Was incorrect. 


RESTRICTED COMMAND "command’ 


Explanation: An attempt was made to execute the command identified 
by "command’ which is not authorized for execution by the 
originating remote operator or user. 


System Action: The command has no effect, and normal processing 
continues. 


Operator Action: Retry the command if it was incorrect. Direct 
questions concerning authorization for command execution to local 
RSCS support personnel. Contact the RSCS operator for any special 
line, file, or routing requests. 


INVALID LOCATION "locid’ 


Explanation: A previously entered command specified as its object 
a location ID identified by "locid’ which was not valid. The 
invalid location ID may have contained more than eight characters, 
or may have contained no characters at all. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command if it Was incorrect. 


ACCEPTED BY TASK ‘task’ 


Explanation: The preceding console command has been processed by 
the RSCS syntax scanner and first level semantic processor, and a 
command element has been built. That command element has been made 
available to the task named ‘'task", and that task has accepted the 
command element for second level semantic processing. 


System Action: Command semantic processing continues at the task 
named ‘task’. Further response to the command will be issued from 


that task. 


Operator Action: None. 


REJECTED BY TASK ‘task’ -— PREVIOUS COMMAND ACTIVE 


Explanation: The preceding console command has been processed by 
the RSCS syntax scanner and first level semantic processor. A 
command element has been built and made available to the task named 
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DMT xxx302E 


DMT xxx303E 


DMT xxx304E 


"task", but that task was unable to accept the command element for 
further processing because a previously issued command was still 
being actively processed. 


System Action: The command execution is terminated, the command 
has no effect, and normal processing continues. 


Operator Action: Retry the command. Command execution will be 
successful when previous command processing is complete. 


LINK ‘linkid* IS NOT DEFINED 


Explanation: The syntactically valid link ID identified by 
*linkid’ was entered in the preceding console command, but no such 
link is defined with that ID and the command issued requires a 
defined link ID. 


System Action: The command execution is terminated, the command 
has no effect, and normal processing continues. 


Operator Action: Check to see if the link ID was specified as 
intended. If it was incorrectly typed, retry the command with a 
correct link ID. If it was correctly typed, you must define the 
specified link in an RSCS DEFINE command or in a LINK statement in 
the RSCS directory before the command can be executed. 


LINK *linkid’ IS NOT ACTIVE 


Explanation: The link identified by "linkid’ was specified in the 
preceding command, but the link is inactive and the command 
requires specification of an active link. 


System Action: The command execution is terminated, the command 
has no effect, and normal processing continues. 


Operator Action: Verify that the command was entered as intended. 
Retry the command if it was incorrectly entered, or activate the 
specified link prior to retrying the command. 

REJECTED BY TASK ‘task* —-— NOT RECEIVING 

Explanation: Processing of the preceding command could not be 
completed because the second level processing task named ‘task’ 


refused to accept the command service request from the REX task. 


system Action: The command is ignored, and normal processing 
continues. 
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DMTCMX310E 


DMT xxx320E 


DMTRGX330E 


Operator Action: Repeated occurrences of this message indicate a 
system error; notify local RSCS support personnel in this case. 


LOCATION "locid' IS NOT DEFINED 


Explanation: A previously entered command specified as its object 
a location ID identified by ‘locid’ which was valid, but Which was 
not defined as a direct link or an indirect route at the time of 
command processing. 


system Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command if it Was incorrect. A DEFINE 
command may be executed to temporarily define a new link, or a 
ROUTE command may be executed to temporarily define a new 
indirectly routed location. Corresponding LINK and ROUTE entries 
should be made to the RSCS DIRECT file for permanent directory 
definitions. 


LINK *linkid’*® NOT CONNECTED 


Explanation: A previous MSG or CMD command was addressed by its 
originator such that it would have been transmitted on the link 
identified by ‘linkid’. This means either that the command's 
destination location address was the link's location Cidentified by 
"linkid’), or that the destination location Was routed by the local 
RSCS via that link. When the command was presented to the link’s 
line driver for transmission, the line driver was unable to 
successfully communicate with the remote station due to a 
malfunction in the telecommunications hardware or the remote 
station. 


System Action: The message or command is discarded, and normal 
processing continues. 


Operator Action: Inspect the link’s telecommunications hardware 
for indications of line disconnection or malfunction. When the 
problem has been corrected, normal processing will begin, and the 
response message to a QUERY "locid’ command will say ‘CONNECT’ 
rather than "ACTIVE". Retry the CMD or MSG command when the link 
has been reconnected. 


USERID MISSING OR INVALID 


Explanation: In a preceding RSCS MSG command the userid was not 
supplied or was invalid at its destination location. 


System Action: The message is discarded undelivered. 


5B-138 IBM VM/370: RSCS Networking — Ref and Operations 


DMTRGX331E 


DMTRGX332E 


DMTIRX400I 


DMTINI41 01 


User Action: Retry the MSG command if it was entered in error. 


*userid' NOT LOGGED ON 
Explanation: The user identified by ‘userid’ which was specified 
in an RSCS MSG command could not receive the message because the 
user was not logged on. 


System Action: The message’ is discarded undelivered. 


User Action: Retry the MSG command later. 


userid’ NOT RECEIVING 

Explanation: The user identified by ‘userid’ which was specified 
in an RSCS MSG command could not receive the message either because 
the user's console is disconnected or because the user has set 
messages or warnings off by using the CP SET command. 


System Action: The message is discarded undelivered. 


User Action: Retry the MSG command later. 


RSCS DIRECT mm/dd/yy hh:mm, nn MAX ACTIVE LINKS, tt TAGS 


Explanation: This message is generated at system initialization 
immediately after the initial RSCS message DMTIRXO000I. The 
directory file (RSCS DIRECT) used to initialize RSCS was last 
modified at the date and time specified by mm/dd/yy hh:mm. 


nn is the maximum number of links that may be active at one time. 
This number is calculated based on the virtual storage size of 


the RSCS virtual machine. 


tt. indicates the total number of available tag slots. This 
number also depends on available virtual storage size. 


System Action: Initialization proceeds with the execution of the 
PROFILE RSCS command file, if any, and normal RSCS processing 
begins. 

Operator Action: Verify the version of the RSCS directory used for 
Initialization. 


NUCLEUS WRITE COMPLETE 


Explanation: The RSCS nucleus has been successfully written to the 
RSCS system disk. 
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DMTINI411R 


DMTINI412R 


System Action: A masked off wait state PSW is loaded with a wait 
State code of X'12’. 


Operator Action: Test the newly loaded RSCS by IPLing the RSCS 
system disk onto which the nucleus was written. 


SYSTEM DISK ADDRESS = {cuu} 


Explanation: The RSCS loader is prompting the operator for the 
virtual device address of the disk onto which the RSCS nucleus is 
to be written. This disk becomes the RSCS system disk. 


System Action: If an invalid device address is entered, message 
DMTINIGS1E INVALID DEVICE ADDRESS — REENTER is issued. Message 
DMTINIGOSR is then reissued, and a valid RSCS system disk virtual 
device address may be entered. 


If the IPL device designated is not currently defined, is not in 
read/write status, or 1S an unsupported device type, message 
DMTINIGS8GE IPL DEVICE ERROR — REENTER is issued. Message 
DMTINIG11R is then reissued. 


Operator Action: Normally, enter the virtual device address of the 
disk to become the RSCS system disk. If your initial entry was 
rejected, enter CP console function mode by signalling attention, 
and determine the status of the designated device by entering the 
CP command: 


QUERY VIRTUAL cuu 
Take corrective action to define the device for the RSCS virtual 
machine, or to access it in read/write status. Reenter RSCS by 
issuing the CP command: 

BEGIN 
Enter the RSCS system device address in response to this message. 
After the IPL device address is accepted, message DMTINI412R is 
issued. 
REWRITE THE NUCLEUS ? {YES|NO} 
Explanation: The RSCS loader is prompting the oprerator for a 
decision as to whether or not the RSCS nucleus is to be rewritten 
to the system disk. 
System Action: If a response other than “yes” or “no” is given, 
message DMTINI483E INVALID REPLY — ANSWER “YES” OR “NO” is issued. 


Message DMTINI412R is reissued and a valid response may be entered. 


If "no" is entered, the remaining questions pertaining to the 
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DMTINIG13R 


writing of the RSCS nucleus are skipped, and initialization is 
immediately begun by the RSCS system which has been loaded into 
virtual storage. 


If "yes”™ is entered, message DMTINIG13R is issued. 


Operator Action: Enter "yes" or "no"™, as described above. 


NUCLEUS CYL/BLK ADDRESS = {nnn} 


Explanation: The RSCS loader is prompting the operator for the 
cylinder or block address on the designated RSCS system disk to 
which the RSCS nucleus 1s to be written. ‘nnn’ is to be entered in 
decimal, and normally is the number of the first cylinder or block 
beyond the area of the disk in use for CMS files. (The block 
number must be a multiple of 256.) This number will normally be 
the same as the number of cylinders or blocks previously specified 
in the CMS command: | 


FORMAT cuu mode nnn CRECOMP 


System Action: If a valid decimal cylinder or block number is not 
entered, message DMTINIG&2E INVALID CYL/BLK NUMBER — REENTER is 
issued, followed by reissue of message DMTINIGI13R. 


If the cylinder or block specified is not greater than the number 
of cylinders or blocks already in use on the device for CMS files 
(as specified in a preceding CMS FORMAT command), the message 
DMTINIG85E NUCLEUS CYL/BLK SPECIFICATION UNACCEPTABLE, ERROR 'x’ is 
issued. Message DMTINIG13R is then immediately reissued. 


When the nucleus cylinder address is correctly entered, message 
DMTINIG1OR is issued. 


Operator Action: Normally, enter the cylinder or block number as 
described above. If your initial entry was rejected, proceed as 
follows: Reenter the cylinder or block number correctly if it was 
entered in error. If the cylinder or block number was entered 
correctly, the cylinder or block number is not valid and you must 
determine a valid number. Use the CMS command: 


QUERY DISK mode 


to determine the number of cylinders or blocks formatted for use by 
the CMS file system. Use the CP command: 


QUERY VIRTUAL vaddr 


to determine the total number of cylinders or blocks on the virtual 
disk. If the number of cylinders or blocks in use for CMS is less 
than the total number available on the disk, use the number of 
cylinders or blocks in use for CMS files as the RSCS nucleus 
cylinder or block address when you retry the RSCS load. If the 
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DMTIRX4491 


DMTIRX4S0E 


number of cylinders or blocks in use for CMS files equals the total 
number available on the disk, use the CMS command: oJ 


FORMAT vaddr mode nnn CRECOMP 
to reduce the number of cylinders or blocks in use by CMS, as 
described in the RSCS installation procedures in Part 2 of this 


manual. 


Typical values for ‘nnn* are as follows, depending on the type of 
disk to be used for the RSCS system disk: 


For a 2314: 006 


For a 3330: 003 
For a 3340: 008 
For a 3350: 0902 
For a 3380: 002 
For a 3310 or 3370: 1536 


MAX TAGS REQUEST OF 1 PER VIRTUAL STORAGE K ASSUMED 


Explanation: The RSCS directory contained a valid TAGS entry 

requesting more than the maximum number of tag slots allowed for 

the virtual storage size in use. The referenced TAGS statement is 

typed immediately preceding this statement. The maximum number of ' 
extra tag slots is one for each 1024 bytes of virtual storage. J 


System Action: The maximum number of extra tag slots is generated, 
and normal initialization proceeds. 


Operator Action: Verify that the correct RSCS directory is in use 
and that the RSCS virtual machine has the intended virtual storage 
size. If both are the case, modify the TAGS entry in the RSCS 
directory to request a number of extra tag slots no greater than 
the allowed maximum for the virtual storage size in use. 


INVALID DIRECTORY ENTRY 


Explanation: During initialization, the RSCS directory was found 
to contain a record which was neither a comment nor a valid 
directory entry. The referenced record is typed immediately 
preceding this message. 


System Action: The record is ignored and normal initialization 
processing continues. 


Operator Action: Update the directory to correct the desired entry 
or to eliminate the invalid record. 
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DMTIRX451E 


DMTIRX452E 


DMTIRX453E 


DMTIRX454E 


DIRECTORY ENTRY OUT OF ORDER 


Explanation: During initialization, an RSCS directory entry was 
recognized in a position which either precedes a prerequisite entry 
or follows a valid entry which it is required to precede. The 
referenced entry is typed immediately preceding this message. 


System Action: The entry is ignored, and normal initialization 
processing continues. 


Operator Action: Update the RSCS directory to correct the 
erroneous order of entries. 


LOCAL PREVIOUSLY SPECIFIED 


Explanation: During initialization, an RSCS directory entry 
describing the local location ('LOCAL’) Was recognized after the 
acceptance of a previous valid LOCAL entry. The referenced entry 
is typed immediately preceding this entry. 


System Action: The first LOCAL entry remains in effect, the 
subsequent LOCAL entry is ignored, and normal initialization 
processing continues. 


Operator Action: Update the RSCS directory to include only one 
LOCAL entry. 


PARM PREVIOUSLY SPECIFIED FOR LINK 


Explanation: During intialization, the RSCS directory was found to 
contain an entry specifying a default START parm ("PARM') on a link 
for which a previous valid PARM entry had been encountered. The 
referenced entry is typed immediately preceding this message. 


System Action: The subsequent PARM entry is ignored, the first 
PARM entry encountered for the link remains in effect, and normal 
initialization processing continues. 


Operator Action: Update the RSCS directory to remove multiple PARM 
entries which specify the same link. 


TAGS PREVIOUSLY SPECIFIED 


Explanation: During initialization, the RSCS directory was found 
to contain more than one request for extra tag slots ("*TAGS’). 
This message is produced each time a TAGS entry is encountered 
after a valid previous TAGS record was processed. The subsequent 
TAGS entry is typed immediately preceding the message. 
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DMTIRX455E 


DMTIRX456E 


DMTIRX457E 


System Action: The first valid TAGS entry encountered in the RSCS 
directory remains in effect. The subsequent TAGS entry is ignored, 
and normal initialization processing continues. 


Operator Action: Update the RSCS directory to contain a single 
valid TAGS entry. 


DUPLICATE LOCATION ID 


Explanation: During initialization, the RSCS directory was found 
to contain a routing entry (*’ROUTE’) Which specified a destination 
location ID which had been specified in a valid previous ROUTE 
entry. The subsequent ROUTE entry is typed immediately preceding 
this message. 


System Action: The original ROUTE entry remains in effect, the 
subsequent ROUTE entry is ignored, and normal initialization 
processing continues. 


Operator Action: Update the RSCS directory to contain no more than 
one ROUTE entry for a single, unique destination location ID. 


DUPLICATE LINK ID 


Explanation: During initialization, the RSCS directory was found 
to contain a link definition entry (*LINK*") specifying a link ID 
which had been specified in a valid previous LINK entry. The 
subsequent LINK entry is typed immediately preceding this message. 


System Action: The preceding LINK entry remains in effect, the 
subsequent LINK entry is ignored, and normal initialization 
processing continues. 


Operator Action: Update the RSCS directory to include no more than 
one LINK entry which specifies a single, unique link ID. 


DUPLICATE PORT ADDRESS 


Explanation: During initialization, the RSCS directory was found 
to contain more than one switchable port entry (’*PORT’) which 
specified the same port address. The subsequent PORT entry is 
typed immediately preceding this message. 


System Action: The preceding PORT entry remains in effect, the 
subsequent PORT entry is ignored, and normal initialization 
precessing continues. 


Operator Action: Update the RSCS directory to contain no more than 
one PORT entry for a single, unique port address. 
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DMTIRX458E 


DMTIRX461E 


DMTIRX462E 


DMTIRX463E 


UNDEFINED LINK ID 


Explanation: During initialization, the RSCS directory was found 
to contain a default parameter entry (*PARM") or a routing entry 
("ROUTE") specifying a link ID for which no link had been defined. 
The referenced entry is typed immediately preceding this message. 


System Action: The PARM or ROUTE entry is ignored, and normal 
initialization processing continues. 


Operator Action: Update the RSCS directory so that all link IDs 
specified in PARM and ROUTE entries have been defined by previous 
LINK entries. 


LOCATION ID MISSING OR INVALID 


Explanation: During initialization, the RSCS directory was found 
to contain a local definition entry C"LOCAL*) or routing entry 
C*ROUTE*) specifying a local or destination location ID which was 
too long or contained invalid characters, or the location ID was 
net specified at all. The referenced LOCAL or ROUTE entry is typed 
immediately preceding this message. 


System Action: The LOCAL or ROUTE entry is ignored, and normal 
Initialization processing continues. 


Operator Action: Update the RSCS directory to contain the valid 
location IDs desired by the installation. 


LINK ID MISSING OR INVALID 


Explanation: During initialization, the RSCS directory was found 
to contain a link definition entry C'LINK'), a default parm entry 
C'PARM"), or a routing entry (*ROUTE’) specifying a link ID which 
Was too long, contained invalid characters, or was identical to the 
previously defined local location ID, or which did not specify a 
link ID at all. The referenced LINK, PARM, or ROUTE entry is typed 
immediately preceding this message. 


system Action: The entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: Update the RSCS directory to contain the valid 
link IDs desired by the installation. 

INVALID DRIVER SPECIFICATION 

Explanation: During initialization, the RSCS directory was found 
to contain a link definition entry C'LINK") specifying a driver 


type (CMS filename) Which Was too long, or which contained invalid 
characters. The referenced LINK entry is typed immediately 
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preceding this message. 


System Action: The entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: Update the RSCS directory to contain the valid 
line driver type desired by the installation. 


DMTIRX464E PORT ADDRESS MISSING OR INVALID 


Explanation: During initialization, the RSCS directory was found 
to contain a link definition entry C*LINK") or switchable port 
entry (C'PORT’) specifying a port address which contained invalid 
characters or which was out of the valid port address range 
CX*002'—-X*5FF*’); or the port address was not specified at all ona 
PORT entry. The referenced LINK or PORT entry is typed immediately 
preceding this message. 


System Action: The LINK or PORT entry in error is ignored, and 
normal initialization processing continues. 


Operator Action: Update the RSCS directory to contain the valid 
port address desired by the installation. 


DMTIRX465E INVALID ZONE SPECIFICATION 


Explanation: During initialization, the RSCS directory was found 
to contain a local location definition entry (*'LOCAL’) or a link 
definition entry (*LINK') specifying a time zone number which 
contained invalid characters, or which was not within the range of 
valid time zone numbers. The time zone number is defined as the 
number of time zone boundaries between the location and Greenwich 
to the east, the International Date Line being included as a time 
zone boundary; and the valid range of time zone numbers is 0 to 24 
decimal. The referenced LOCAL or LINK entry is typed immediately 
preceding this message. 


System Action: The LOCAL or LINK entry in error is ignored, and 
normal initialization processing continues. 


Operator Action: Update the RSCS directory to contain the valid 
time zone number desired by the installation. 


DMTIRX466E INVALID TASK SPECIFICATION 


Explanation: During initialization, the RSCS directory was found 
to contain a link definition entry C’LINK") specifying a default 
task name which contained more than four characters, or invalid 
characters. The referenced LINK entry is typed immediately 
preceding this message. 
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DMTIRX468E 


DMTIRX469E 


System Action: The LINK entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: Update the RSCS directory to contain the valid 
task name desired by the installation. 


INVALID CLASS SPECIFICATION 


Explanation: During initialization, the RSCS directory was found 
to contain a link definition entry ¢*LINK’) specifying a default 
class which contained more than four characters, or invalid 
characters. The referenced LINK entry is typed immediately 
preceding this message. 


System Action: The LINK entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: Update the RSCS directory to contain the valid 
Class specification desired by the installation. 


INVALID KEEP SPECIFICATION 


Explanation: During initialization, the RSCS directory was found 
to contain a link definition entry C"’LINK") specifying a keep 
number which contained invalid characters, or which was not within 
the range of valid keep numbers (0 to 16 decimal). The keep number 
specifies the minimum number of tag slots which are to be kept 
available for exclusive enqueueing of files on the link being 
defined. The referenced LINK entry is typed immediately preceding 
this message. 


System Action: The LINK entry in error is ignored, and normal 
initialization processing continues. 


Operator Action: Update the RSCS directory to contain the valid 
number of tag slots desired by the installation to be reserved for 
the link to be defined. 


TAGS COUNT MISSING OR INVALID 


Explanation: During initialization, the RSCS directory was found 
to contain a tag slot request entry (*TAGS’) which specified an 
extra tag slot count containing invalid characters, or which was 
not within the valid range for extra tag slot requests (1 to 16384 
decimal). The referenced TAGS entry is typed immediately preceding 
this message. 


System Action: The TAGS entry in error is ignored, and normal 
initialization processing continues. 
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DMTINIG81E 


DMTINI482E 


DMTINIGS3E 


DMTINIGS84E 


DMTINIG85E 


Operator Action: Update the RSCS directory to specify the valid 
keep number of extra tag slots desired by the installation. } 
INVALID DEVICE ADDRESS — REENTER 

Explanation: The device address entered was not correct. It 
either included at least one character which is not a valid 
hexadecimal digit (0-9, A-F) or it was not within the range of 
valid device addresses (X*'001]1'=X'5SFF*). 


System Action: Message DMTINIG11R is reissued. 


Operator Action: See the description of message DMTINI411R. 


INVALID CYL/BLK NUMBER — REENTER 
Explanation: Either zero or an invalid decimal number was entered. 
System Action: Message DMTINI413R is reissued. 


Operator Action: See the description of message DMTINIG13R. 


INVALID REPLY — ANSWER "YES" OR "NO 
Explanation: The only valid responses to the query are ‘yes’ or al 


"no'. Neither was entered. 
System Action: Message DMTINIG12R is reissued. 


Operator Action: See the description of message DMTINI412R. 


IPL DEVICE ERROR — REENTER 

Explanation: The virtual device address entered as the address of 
the RSCS system disk was not defined (attached) for the RSCS 
Virtual machine, or the disk was not in write/read status, or the 
device at the entered address iS not supported. 


System Action: Message DMTINIG11IR is reissued. 


Operator Action: See the description of message DMTINIG11R. 


NUCLEUS CYL/BLK SPECIFICATION UNACCEPTABLE, ERROR *x’!". 


Explanation: The specified nucleus cylinder or block number was 
not acceptable for the reason indicated by error code ‘x’: 


x Error Explanation ) 
1 Would cause over-write of CMS files 
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2 Not enough blocks formatted 
3 Block number not a multiple of 256 
4 Not enough blocks on device 


System Action: Message DMTINIG13R is reissued. 


Operator Action: See the description of message DMTINIG13R. 


DMTIRX490T 


DMTIRX491T 


DMTIRX492T 


UNSUPPORTED SYSTEM RESIDENCE DEVICE TYPE 


Explanation: The VM/370 device type code for the I/O device from 
which RSCS was IPLed was not recognized as a DASD device type 
supported by RSCS as a system residence device. 


System Action: RSCS initialization is terminated, and a masked off 
Wait state PSW is loaded. 


Operator Action: Reload RSCS to a DASD supported by RSCS as a 
system residence device. 


FATAL ERROR READING RSCS DIRECT 


Explanation: An unrecoverable I/O error occurred during 
initialization on the RSCS system residence device. The most 
likely cause of this error is the absence of the RSCS directory 
file (RSCS DIRECT) from the system residence device. Other 
possible causes include VM/370 sysgen or directory errors invloving 
the RSCS system residence device, CMS or editor system errors in 
writing the RSCS DIRECT file, incompatible CMS file system update 
levels, or machine malfunctions on the associated real I/O device. 


System Action: RSCS initialization is terminated, and a masked off 
Wait state PSW is loaded. 


Operator Action: Retry the RSCS IPL. If the error condition 
persists, investigate the possible causes listed in the explanation 
above, and correct any specification errors found. If the error 
condition continues to persist, or if it arises intermittently, 
dump RSCS using the CP command: 


DUMP O— 


Submit the resulting dump to local RSCS Support personnel. 


FATAL ERROR LOADING DMTAXS 


Explanation: An unrecoverable 1/0 error occurred during the 
initial loading of the RSCS DMTAXS module. The most likely causes 
of this error are the absence of the DMTAXS TEXT file from the RSCS 
system residence device, or the incorrect naming of the file as 
DMTAXS TXTxxxx. Other possible causes include CMS or assembler 
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DMT IRX493T 


DMTIRX494T 


system errors in writing the DMTAXS TEXT file, incompatible CMS 
file system update levels, or machine malfunctions on the 
associated real I/0 device. 


System Action: RSCS initialization is terminated, and a masked off 
Wait state PSW is loaded. 


Operator Action: Retry the RSCS IPL. If the error condition 
persists, investigate the possible causes listed in the explanation 
above and correct any specification errors found. If the error 
condition continues to persist, or if it arises intermittently, 
dump RSCS using the CP command: 


DUMP O-— 


Submit the resulting dump to local RSCS Support personnel. 


FATAL ERROR LOADING DMTLAX 


Explanation: An unrecoverable 1/0 error occurred during the 
initial loading of the RSCS DMTLAX module. The most likely causes 
of this error are the absence of the DMTLAX TEXT file from the RSCS 
system residence device, or the incorrect naming of the file as 
DMTLAX TXTxxxx. Other possible causes include CMS or assembler 
system errors in writing the DMTLAX TEXT file, incompatible CMS 
file system update levels, or machine malfunctions on the 
associated real I/0 device. 


System Action: RSCS initialization is terminated, and a masked off 
Wait state PSW is loaded. 


Operator Action: Retry the RSCS IPL. If the error condition 
persists, investigate the possible causes listed in the explanation 
above and correct any specification errors found. If the error — 
condition continues to persist, or if it arises intermittently, 
dump RSCS using the CP command: 


DUMP O-— 


Submit the resulting dump to local RSCS support personnel. 


LOCAL LOCATION DEFINITION MISSING 


Explanation: During initialization, no valid local location 
definition entry (*LOCAL’) Was encountered in the RSCS directory. 
The local location definition must be included as the first 
non—comment entry in the RSCS directory. No directory entry is 
accepted until a valid LOCAL entry has been processed. 


System Action: RSCS initialization processing is terminated, and a 
masked off wait state PSW is loaded. 
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DMTIRX495T 


DMTINI498S 


DMT INI499T 


Operator Action: Update the RSCS directory to contain a valid 
LOCAL entry as the first non-comment directory entry. 


VIRTUAL STORAGE SIZE INSUFFICIENT FOR INITIALIZATION 


Explanation: During initialization, it was determined that the 
RSCS virtual machine size was less than 384K. 


System Action: RSCS initialization processing is terminated, anda 
masked off wait state PSW is loaded. 


Operator Action: Redefine the RSCS virtual machine size to 384K 
(or greater) by using the CP DEFINE command: 


DEFINE STORAGE 384K 


and re—-IPL RSCS. 


IPL DEVICE WRITE I/0 ERROR 


Explanation: An uncorrectable I/0 error occurred while writing the 
RSCS nucleus. 


System Action: RSCS load processing is halted, and a masked off 
Wait state PSW of code X'1l2" is loaded. 


Operator Action: See the description of message DMTINIG13R. 
Verify that the nucleus cylinder or block number entered in 
response to message DMTINIG13R is not larger than the total number 
of cylinders or blocks on the specified RSCS system disk, and 
verify that the RSCS system disk is in write/read mode. If no 
error can be determined, notify local RSCS support personnel. 


IPL DEVICE READ I/O ERROR 


Explanation: An uncorrectable I/0 error occurred while reading the 
RSCS nucleus from the RSCS system disk during RSCS initialization. 


System Action: RSCS loads the WAIT PSW. Since RSCS runs disabled 
for all interrupts during initialization, the loading of this PSW 


causes RSCS to enter a hard wait state. 


Operator Action: Check the device, recreate the RSCS system disk 
if necessary, and re-issue the IPL command. 
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DMT AXMS5 001 


DMTAXMS01E 


DMT AXM5 02E 


DMT xxx510I] 


"nn? FILE(S) CLOSED ON LINK ‘linkid’ 


Explanation: A number of files denoted by ‘nn’ that were active on 
the inactive link identified by ‘'linkid’ have been deactivated 
either in response to an RSCS CLOSE command, or as an automatic 
result of link deactivation. 


System Action: Previously active input files are reenqueued for 
complete retransmission. Previously active output files are 


normally incomplete, and are therefore purged. 


Operator Action: None. 


LINK *linkid’ ACTIVE -— NO FILE(S) CLOSED 


Explanation: The RSCS operator attempted to issue a CLOSE command 
to an active link specified by ‘linkid’. 


System Action: CLOSE command processing is suppressed and file 
status remains uachanged. 


Operator Action: Reissue the command after the link has been 
deactivated. 


FILE *spoolid’ INACTIVE —~— NO ACTION TAKEN 


Explanation: The file identified by ‘spoolid’ is already inactive. 
The action requested by the preceding command could not be 
performed. 


System Action: The preceding command has no effect, and normal 
processing continues. 


Operator Action: Verify the spool file ID used in the preceding 
command. If it was incorrect, retry the command with a corrected 
spool file ID. If it was correct, and the file is inactive, the 
preceding command was not valid for inactive files. 


FILE *"spoolid® BACKSPACED 


Explanation: The file identified by "‘spoolid*’ has been backspaced 
according to the request in the previous BACKSPAC command. 


System Action: File transmission continues, beginning from the new 
file position. 


Operator Action: None. 
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DMTxxx511E 


DMTAXM52 01 


DMT AXM5211 


DMT AXM5221 


NO FILE ACTIVE ON LINK ‘"linkid’ 


Explanation: A valid command for active files Was issued to the 
link identified by "linkid’, but no file was being actively 
transmitted on the link at the time of command execution. 


System Action: Normal link processing continues, and the command 
has no effect. 


Operator Action: Retry the command if it Was entered in error. 


FILE *spoolid’ CHANGED 


Explanation: The file identified by "spoolid’ has been altered as 

requested in the processing of the preceding command. The new file 
status remains in effect until it is changed again through operator 
command processing. 


system Action: All appropriate action implied by the change of 
Status is performed. This might include reordering a link queue if 
a file priority was changed, notifying a waiting line driver if a 
file class was changed, and so on. Normal RSCS processing 
continues. 


Operator Action: None. 


FILE *spoolid’ HELD FOR LINK ‘linkid’ 


Explanation: The file identified by "spoolid’ has been placed in 
hold status as the result of processing of the preceding command. 
The file will be kept in hold status and will not be transmitted 
until it is removed from hold status by command processing. 


Operator Action: None. 


FILE "spoolid’® RELEASED FOR LINK ‘linkid’ 


Explanation: The file identified by "spoolid’ and enqueued on the 

link identified by ‘'linkid’ has been released from hold status as a 
result of the processing of the preceding command. The file is now 
eligible for transmission on the link. 


System Action: The released file will be selected for transmission 
according to the normal rules of file priority. The link’s line 
driver is asynchronously notified of the file’s availability for 
transmission if the line driver had been waiting for a file to 
transmit. Normal RSCS processing continues. 


Operator Action: None. 
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DMT AXM524E 


DMT AXM5 25E 


DMT AXM526E 


LINK *linkid® QUEUE REORDERED 


Explanation: The file tag queue in RSCS virtual storage for the 
link identified by ‘linkid’® has been reordered in response to 
execution of a command. The new order of the queue represents the 
order of file transmission for the link. 


system Action: The files reordered to the beginning of the queue 


are given a priority of zero (highest), and normal processing 
continues 


Operator Action: None. 


FILE *spoolid’® ACTIVE -—- NO ACTION TAKEN 


Explanation: The file identified by "*spoolid’ is actively being 
read and transmitted on a link, and the action requested in the 
preceding command cannot be performed on active files. 


system Action: The preceding command has no effect, and normal 
processing continues. 


Operator Action: If desired, deactivate the file by means of a 
FLUSH *linkid*® "*spoolid’ HOLD command, and retry the preceding 
command. 

FILE *spoolid’ IS FOR LINK ‘linkid’ =-— NO ACTION TAKEN 
Explanation: The file identified by "spoolid’ is enqueued on the 
link identified by "linkid’, which is different from the linkid 


specified in the preceding command. 


System Action: The action requested in the preceding command is 
not performed, and normal processing continues. 


Operator Action: Verify that the specified spool file ID and link 


ID are correct. If an error is found, retry the preceding command. 


FILE "*spoolid* NOT FOUND -— NO ACTION TAKEN 


Explanation: The file identified by ‘"*spoolid’ which was specified 
in the preceding command is not owned by RSCS, or is pending. 


System Action: The preceding command has no effect, and normal 
processing continues. 


Operator Action: Verify the spool file ID used in the preceding 
command. If it was incorrect, retry the command with a corrected 
spool file ID. If it was correct, and the file is pending at the 
RSCS virtual machine, you may manipulate the file through the use 
of VM/370 CP spooling commands. 
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DMT CMY540I 
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INVALID LINE DRIVER COMMAND FOR LINK 'linkid' -— NO ACTION TAKEN 


Explanation: A line driver-type RSCS command has been recognized 
for the link specified by "linkid’. The command is invalid for the 
particular line driver that is controlling this link. 


System Action: Normal RSCS processing continues. 


Operator Action: None. 


NEW LINK *linkid’ DEFINED 


Explanation: The link identified by ‘linkid’ is now defined as the 
result of RSCS DEFINE command processing. Attributes of the newly 
defined link are determined by the specified and default DEFINE 
command options. Users may begin addressing files, commands, and 
messages to the newly defined link. 


System Action: The RSCS file queue iS reordered. Files may be 
enqueued on the newly defined link. The new link definition will 
remain in effect until RSCS is restarted, or until it is removed by 
an RSCS DELETE command. 


Operator Action: Add a LINK statement defining the new link to the 
RSCS directory to cause the link to be defined after an RSCS 
restart. 

LINK *linkid*® REDEFINED 

Explanation: The previously defined link, identified by "linkid’, 
has had its definition changed as the result of command processing, 


according to the specified keyword options. 


system Action: The changes in the link definition become effective 
immediately. 


Operator Action: None. 


LINK "linkid’® ACTIVE ~— NOT REDEFINED 
Explanation: The previously defined link, identified by "linkid’, 
has not been redefined because the link was active at the time of 


command processing. 


System Action: Command execution is terminated, the command has no 
effect, and normal processing continues. 


Operator Action: Retry the command after the link has been 
deactivated. 
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DMTCMY543E 


DMTCMYS501 


DMTCMYS551E 


DMT CMY552E 


LINK "linkid’ NOT DEFINED ——~ LINK LIMIT REACHED 


Explanation: An attempt was made to define a new link, but the 
maximum allowable number of defined links had already been reached. 


System Action: Command execution is terminated, the command has no 
effect, and normal processing continues. 


Operator Action: Check the command line to see if it was 
accurately typed. If an existing link definition was to have been 
altered, retry the command with a corrected command line. If a new 
link Was to be defined, temporarily remove another link from RSCS 
by means of the RSCS DELETE command before retrying the command. 


LINK *linkid’* NOW DELETED 


Explanation: The previously defined link, identified by ‘linkid’, 
1S NOW temporarily deleted as a result of RSCS DELETE command 
processing. Files, commands, and messages can no longer be handled 
through the previously defined link. 


System Action: Spool files addressed to the deleted link's 
location ID are no longer accepted, and are rejected as invalidly 
addressed. Such files may be returned to local originating users, 
or are purged if they are not of local origin. The deleted link 
can no longer be activated. 


Operator Action: None. 


LINK "*linkid’ ACTIVE ~— NOT DELETED 


Explanation: An attempt was made to temporarily delete the link 
identified by "‘linkid’ from RSCS by the RSCS DELETE command. The 
attempt was unsuccessful because the specified link was active at 
the time of command processing. 


System Action: The link remains defined and active, the command 
has no effect, and normal processing continues. 


Operator Action: Retry the command after the link has been 
deactivated. 


LINK "linkid’ HAS A FILE QUEUE —— NOT DELETED 


Explanation: An attempt was made to temporarily delete the link 
identified by "linkid’ by an RSCS DELETE command. The attempt was 
unsuccessful because the specified link had at least one file 
enqueued on it at the time of command processing. 


System Action: The link remains defined, the command has no 
effect, and normal processing continues. 
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DMTCMX5601 


DMTCMXS561E 


DMT xxx570I 


Operator Action: Before the link can be deleted, all files 
enqueued on it and pending for it must be purged, either by console 
command execution or through normal file transmission. 


RSCS NETWORKING DISCONNECTING 


Explanation: The RSCS virtual machine console is disconnected as a 
result of command execution. If an alternate virtual machine was 
specified to receive RSCS output messages, that virtual machine 
Will begin receiving the console messages through the VM/370 MSG 
function. 


System Action: RSCS continues processing normally without a main 
operator console. 


Operator Action: Reconnect the RSCS main virtual machine console 
through the normal VM/370 LOGON procedure. 


USERID *userid® NOT RECEIVING 


Explanation: An attempt was made to disconnect the main RSCS 
virtual operator console with a secondary virtual machine ID 
identified by *’userid’ specified to receive RSCS console output 
messages. The specified virtual machine either was not receiving 
messages or Was not logged on at the time of command processing. 


System Action: The command processing is terminated, the command 


-has no effect, and normal processing continues. 


Operator Action: Retry the command with a different virtual 
machine ID specified, or With no virtual machine ID specified. The 
same virtual machine ID can be specified after it has been logged 
on and set to receive messages. 


LINK *linkid’® NOW SET TO DEACTIVATE 


Explanation: In response to the DRAIN command, the link identified 
by *linkid’ has set drain status and will be deactivated. If the 
RSCS operator issues the START command before the link is 
deactivated, drain status will be reset and processing will 
continue on the link. 


System Action: If the line driver is not in active communication 
with the remote station at the time of DRAIN command execution, the 
link is deactivated immediately. Otherwise, action is taken to 
quiesce line activity. This includes the finishing of transmission 
for an active file if one exists, and it may include the signaling 
to the remote station of an impending termination. File reception 
is completed for a file which is being actively received. No new 
files are activated for transmission or accepted for reception 
While the link iS in drain status. When line activity is quiesced, 
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DMTxxx571E 


DMT xxx5 80] 


DMTxxx5381E 


the link deactivates. 


Operator Action: If the DRAIN command fails to deactivate the link 
Within a reasonable period of time, issue a FORCE command to 
deactivate the link unconditionally, regardless of actual line 
activity. 


LINK "linkid’ ALREADY SET TO DEACTIVATE 


Explanation: A DRAIN command was executed specifying the link 
identified by "linkid', which was already in drain status as the 
result of a previous DRAIN command. 


System Action: The line driver continues its attempts to gQuiesce 
the line, and the command has no effect. 


Operator Action: If the DRAIN command fails to deactivate the link 
Within a reasonable period of time, issue a FORCE command to 
immediately deactivate the link, regardless of line activity. 


FILE *spoolid’ PROCESSING TERMINATED 


Explanation: Transmission of the active file identified by 
"spoolid’ has been terminated before the completion of file 
processing. This message is issued either in response to a FLUSH 
command, or when a remote system is restarted. 


System Action: Disposition of the identified file is made 
according to the status of the file. The file may be purged from 
the system, or the file may be held for future retransmission. If 
a FLUSH command was entered, the next copy of the file may begin 
transmission if multiple copies remain and 'ALL*™ was not specified. 
Normal link processing continues. 


Operator Action: None. 


FILE "*spoolid’ NOT ACTIVE 


Explanation: This message is in response to an RSCS command which 
requires specification of an active file as the command’s object. 
At the time of command processing, the spoolid specified in the 
command (*spoolid’) was not active. 


System Action: The command has no effect, and normal link 
processing continues. 


Operator Action: You may determine the status of a file by issuing 
a QUERY FILE "*spoolid'’ command. Retry the command if it was 
entered in error. 
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DMTxxx590I LINK "linkid’ RESUMING FILE TRANSFER 
Cc Explanation: The active link identified by "linkid’® was in hold 
status, and has been removed from hold status in response to FREE 


command processing. 


System Action: File transmission on the identified link resumes 
When a file eligible for transmission 1s available. 


Operator Action: None. 


DMTxxx591E LINK "linkid’ NOT IN HOLD STATUS 
Explanation: The link identified by "linkid’ was not in hold 
Status when a FREE command was processed requesting that the link 


leave hold status. 


System Action: The command is ignored, and normal link processing 
continues. 


Operator Action: None. 


DMTxxx600I FILE "spoolid’ FORWARD SPACED 


Explanation: The file identified by "Spoolid’ has been forward 
i spaced as requested by a preceding FWDSPACE command. 


System Action: File transmission continues, beginning from the new 
file position. 


Operator Action: None. 


DMTxxx610I LINK "linkid’ TO SUSPEND FILE TRANSMISSION 


Explanation: The link identified by "linkid’ has entered hold 
status. File transmission has not been suspended because at the 
time of command processing a file was being actively transmitted, 
and the "IMMED’ option was not specified. 


System Action: The link remains in hold status. File transmission 
Will be suspended when the processing of currently active output 


files has been completed. 


Operator Action: None. 


DMTxxx61l1lI LINK "linkid’ FILE TRANSMISSION SUSPENDED 


Explanation: This message is in response to HOLD command 
( processing. The link identified by "linkid’® has entered hold 
status, and file transmission has been halted. Either no file was 
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DMTCMX626I1 


being actively transmitted at the time of command processing, or 
the link had been in hold status and its active file transmission 
has completed, or an active file was being transmitted and the 
,IMMED' operand was specified. 


System Action: The link remains in hold status, and file 
transmission remains suspended until the link is explicitly freed 
from hold status. If active file transmission Was interrupted, the 
transmission of the active file resumes from the point at which 
transmission was interrupted, when the link is removed from hold 
status. The link continues to process files received from the 
remote station normally while in hold status. 


Operator Action: None. 


LINK "*linkid® ALREADY IN HOLD STATUS 


Explanation: This message is issued in response to HOLD command 
processing. The command requested that the link specified by 
‘linkid® be placed in hold status. The link was already in hold 
status at the time of command processing. 


System Action: The link remains in hold status, and the command 
has no effect. 


Operator Action: None. 


NO PORTS AVAILABLE 


Explanation: This message is issued in response to a QUERY SYSTEM 
PORTS command. At the time of command execution, no switchable 
ports had been defined to RSCS. Switchable ports are defined to 
RSCS by the PORT entry in the RSCS directory (RSCS DIRECT). 


System Action: None. 


Operator Action: None. 


PORT ‘vaddr* AVAILABLE 


Explanation: This message is issued in response to a QUERY SYSTEM 
PORTS command. Either this message or message DMTCMxX627I is issued 
once for each switchable port defined by a PORT entry in the RSCS 
directory (RSCS DIRECT). The switchable port identified by its 
virtual device address ‘'vaddr’ was not in use by an active link at 
the time of command processing. 


System Action: None. 
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Operator Action: None. 


PORT "*vaddr’ IN USE BY LINK ‘linkid' 


Explanation: This message is issued in response to a QUERY SYSTEM 
PORTS command. Either this message or message DMTCMX626I is issued 
once for each switchable port defined by a PORT entry in the RSCS 
directory (RSCS DIRECT). The switchable port identified by its 
virtual device address 'vaddr"* was in use by the active link 
identified by "linkid’ at the time of command execution. 


System Action: None. 


Operator Action: None. 


*locid’ NOW ROUTED THROUGH LINK ‘linkid’ 


Explanation: In response to an RSCS ROUTE command, file, command, 
and message transmission to the location identified by ‘locid’™ may 
be indirectly routed through the link identified by "linkid’. 


System Action: The RSCS routing table has been updated to reflect 
the new indirect route. A direct link and an indirect route may be 
concurrently defined for the same remote location, using a single 
locid. In this case, files, commands, and messages may be 
transmitted directly or indirectly, depending upon dynamic system 
status. 


Operator Action: None. 


INDIRECT ROUTING FOR ‘locid’ DEACTIVATED 

Explanation: In response to a ROUTE command, files, commands, and 
messages addressed to the location identified by "locid’® will no 
longer be indirectly routed. 

System Action: The RSCS routing table has been updated to reflect 
the routing change. Files addressed to the identified location are 
rerouted for direct transmission (if a link is defined), or are 


returned to local originating users, or are purged. 


Operator Action: None. 


*locid’ INVALID ROUTE SPECIFIED 


Explanation: An invalid indirect route for the location identified 
by "locid’ was specified on a preceding ROUTE command. 


System Action: The command is ignored and normal processing 
continues. 
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Operator Action: Retry the ROUTE command with a valid route 
specification. 

| DMTCMY633E *locid’ NOT ROUTED -=— ROUTE LIMIT REACHED 
Explanation: An attempt was made to define a new route by means of 
the ROUTE command, but the maximum allowable number of indirect 


route definitions had already been reached. 


System Action: The command processing iS suppressed, the command 
has no effect, and normal processing continues. 


Operator Action: Delete an existing route definition before 
retrying the command. 
DMTCMX634I NO LOCATIONS ROUTED 


Explanation: This message is in response to a QUERY SYSTEM ROUTES 
command. No indirect routing was defined to RSCS. 


System Action: None. 


Operator Action: None. 


DMTCMX6361I "locid’ ROUTED THROUGH LINK ‘linkid’ 
Explanation: ThiS message is in response to a QUERY ‘locid’ 
command. Files, commands, and messages addressed to the location 
identified by "locid’ may be enqueued for indirect transmission on 
the link identified by "linkid’. 
System Action: None. 


Operator Action: None. 


| DMTCMY637!I ‘locid’ NOT ROUTED 
Explanation: This message iS in response to a ROUTE ‘locid’ OFF 
command. The specified "*locid’ was not defined for indirect 


routing at the time of command processing. 


System Action: No action is taken, and normal processing 
continues. 


Operator Action: Retry the command if it was entered in error. 
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DMTCMY638E LOCATION ‘locid’ HAS A FILE QUEUE -— INDIRECT ROUTING NOT 


DMT AXM6401 


DMT AXM6451 


DMTCMX6511I 


DEACTIVATED 


Explanation: This message is in response to a query "locid’ OFF 
command. The specified location identified by "*locid’ has files 
queued for it on the link it iS routed through. 


System Action: No action is taken, and normal processing 
continues. 


Operator Action: Retry the command if it was entered in error. If 
correct, use the transfer, purge or define commands to remove the 
queued files from the link the ‘locid’ is routed through, and retry 
the command. 


™"nn’ FILE(S) PURGED ON LINK ‘linkid’ 


Explanation: The number of files denoted by ‘nn’ which were 
enqueued on the link specified by "linkid*® have been purged from 
the system in response to a PURGE command. 


System Action: The files* virtual storage tags are dequeued and 


the‘tag slots are released. Pending files for the link are 
accepted if a sufficiently large number of free tag slots results. 


Operator Action: None. 


"nn* FILE(S) TRANSFERRED ON LINK ‘linkid’ 


Explanation: The number of files denoted by ‘nn’ which were 
enqueued on the link specified by "‘linkid*® have been re-addressed 
to a new destination in response to a TRANSFER command. 


system Action: The destination address for the file or files is 
permanently changed, and the files are reenqueued to their new 


destination by a file queue reorder performed by TRANSFER command 
processing. 


Operator Action: None. 


LINK *linkid’ INACTIVE 

Explanation: ThisS message is issued in response to a QUERY ‘locid’ 
command. The location specified in the command was defined for 
direct connection, and its link identified by "linkid’® was not 


active at the time of command processing. 


System Action: None. 


Appendix B: RSCS Messages 5B—-43 


DMT CMX6521 


DMT CMX6531 


Operator Action: None. 


LINK "linkid’ {CONNECT|ACTIVE} ‘task’ ‘type’ "vaddr’? c {HO|NOH} 
{DR|NOD} {NOT|TRS|TRL|TSL} 


Explanation: This message is issued in response to a QUERY ‘locid’ 
command. The location specified in the command was defined for 
direct connection, and its link identified by ‘'linkid’ was active 
at the time of command processing. The CONNECT keyword indicates 
that the line driver successfully received a satisfactory response 
from the remote station on the last attempted exchange. The ACTIVE 
keyword implies that the line driver's last attempted exchange 
failed due to line or remote system failure, or that local 
telecommunications equipment has not been dialed or is not properly 
set. 


task - is the task name of the line driver task. 

type - is the name of the line driver in use for the active link. 

vaddr —- is the virtual device address of the line port in use by 
the active link. 

c - is the class or classes of files that may be processed by 
the active link. 

HO - indicates that the active link is in hold status. 

NOH - indicates that the active link is not in hold status. 

DR - indicates that the active link is in the process of 


draining, and will terminate when line activity is 
quiesced. 


NOD - indicates that the active link is not in the process of 
draining. 

NOT - indicates that no trace option is active for the link. 

TRS - indicates that the trace sum option is active for the 
link, and that the trace log option is inactive. 

TRL - indicates that the trace log option is active for the 
link, and that the trace sum option is inactive. 

TSL - indicates that both the trace sum and trace log options 


are active for the link. 


System Action: None. 


Operator Action: None. 


LINK "linkid’® DEFAULT "task’* ‘type’ ‘'vaddr' c Z=z Re=r 


Explanation: ThiS message iS in response to a QUERY ‘linkid’ DEF 
command, and is issued when a new link is defined or when an 
existing link definition is modified by means of the DEFINE 
command. The link identified by "linkid’ was defined at the time 
of command processing, and the default attributes listed in the 
message pertain to that definition. The message does not indicate 
Whether the link was active or inactive at the time of command 
processing, and the default attributes listed may be different from 
those actually in use with the link if it Was active. 
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DMTCMX654I1 


DMTCMX6551 


task —- the default task name to be associated with the defined 
link’'s line driver task when the link is activated. 


type - the name of the default line driver defined for the 
link. 

vaddr - the default virtual device address of a line port to be 
used by the link when it i585 activated. 

c - the default class or classes of files Which may be 
processed by the link when it is active. 

z - the number designating the terrestrial time zone number 


in which the remote location is defined to reside. This 
is the number of time zone boundaries between the remote 
location and Greenwich to the east, the International 
Date Line being included as a time zone boundary. 

r - the number of virtual storage file tag slots reserved 
for exclusive use by this link. 


System Action: None. 


Operator Action: None. 


LINK "*linkid’® S=s R=r Q=q P=p 


Explanation: This message is issued in response to a QUERY 
Tlinkid’® QUEUE command, and is issued in response to a QUERY SYSTEM 
QUEUE once for each link on Which at least one file is either 
enqueued or active. The status of the file queue for the link 
identified by "‘linkid’® is described. 


S - the number of files being actively transmitted (sent) on 
the link. 
r - the number of files being actively received on the link. 


- the number of files accepted and enqueued for 
transmission on the link. 
p - the number of files pending but not yet accepted for the 
active link. 


System Action: In response to a QUERY "linkid’ QUEUE command, an 
additional message (DMTCMX6551) is issued for each file accepted 
and enqueued on the link, describing the status of each such file. 


Operator Action: None. 


FILE *spoolid’ ('orgid’) "’locid’ "*userid’ CL a PR pp REC nnnnrnnnn 
{HO| NOH} 


Explanation: A message of this form is issued for each file 
accepted and enqueued for transmission on the link specified by 
*linkid’ in the preceding QUERY "linkid* QUEUE command. 


spoolid — the VM/370 spool file ID for the file. 


orgid - the originating VM/370 spool file ID, or the origin job 
number, of the file. 
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DMT CMX6é561 


DMTCMX6é601 


locid —- the destination location ID to which the file is 
addressed. 


userid —- the destination user ID (if any) to which the file is 
addressed. 

a - the spool file class. 

pp - the file’s current transmission priority. 

NnnnvAnnvAnnn — the total number of records in the file. 

HO - indicates that the file is in hold status. 

NOH - indicates that the file is not in hold status. 


System Action: This message iS issued once for each inactive file 
which 15 enqueued and waiting to be transmitted on the specified 
link. 


Operator Action: You may issue the QUERY "linkid’ ACTIVE command 
to determine the status of files being actively transmitted on the 
link. 


FILE "spoolid’® ('orgid’) "locid" ‘userid’ CL a PR pp LEFT mmmmmmmm 
OF nonnnnnn 


Explanation: This message is issued in response to a QUERY 
"linkid* ACTIVE command. The response describes the state of the 
file which was being actively transmitted on the link specified by 
"linkid’ when the QUERY command was executed. 


spoolid — the VM/370 spool file ID for the active file. 

orgid - the originating VM/370 spool file ID, or the origin job 
number, of the file. 

locid - the destination location ID to which the file is 
addressed. 

userid - the destination user ID (if any) to which the file is 
addressed. 

a - the spool file class. 

pp - the file’s current transmission priority. 

mmmmmmmm — the number of records in the file which remain to be 


transmitted. 
nnnnnnvnnn — the total number of records in the file. 


System Action: None. 


Operator Action: You may issue the QUERY "linkid’ QUEUE command to 
determine the status of inactive files enqueued for transmission on 
the link. 


FILE *"spoolid’ INACTIVE ON LINK °linkid’ 


Explanation: This message is issued in response to a QUERY FILE 
*spoolid’ STAT command. At the time of command processing, the 

file identified by "spoolid’® was inactive, and was enqueued for 

transmission on the link identified by "linkid’. 
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DMTCMX6611 


DMTCMX6621 


| DMTCMX6631 


System Action: None. 


Operator Action: None. 


FILE "*spoolid’ ACTIVE ON LINK ‘linkid’ 


Explanation: This message is issued in response to a QUERY FILE 
*spoolid’ STAT command. At the time of command processing, the 
file identified by "spoolid’ was active, and was being transmitted 
on the link identified by ‘linkid’. 


System Action: None. 


Operator Action: None. 


FILE "spoolid’ ORG "locidl’® "useridl’ ORGID ‘orgid’ mm/dd/yy 
hh:mm:ss 2.2.2. TO ‘locid2" ‘*userid2' 


Explanation: This message is in response to the RSCS command QUERY 
FILE *"spoolid’ RSCS. The RSCS control related attributes of the 
file identified by "spoolid’ are described. 


locidl - the location ID of the location at which the file 
originated. 
useridl =- the user ID of the originator of the file. 


orgid - the originating VM/370 spool ID, or the origin job 
number, of the file. 
mm/dd/yy — the file creation date. 


hh:mm:ss — the file creation time of day. 
2.262% - the time zone with reference to which the time of day i5 
expressed. 


locid2 - the destination location ID to which the file is 
addressed. 
userid2 - the destination user ID Cif any) to which the file is 


addressed. 


System Action: None. 


Operator Action: None. 


FILE "spoolid’ PR pp CL a FO ffffffff CO [x]nnn {HO|NOH} DI 
"distcode’, NA {'fn ft"*|"dsname'"} 


Explanation: ThiS message iS isSSUed in response to the RSCS 
command, QUERY FILE "*spoolid’ VM. The VM/370 spool system relat: 
attributes of the file identified by "spoolid’ are described. 


pp the file’s priority. 

a - the file’s spool file class. 

ffffffTf the file’s form number 

[x]nnn - The file’s copy count; the * indicates copies will be 
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made internally in the 3800 printer. 
HO - indicates that the file is in hold status. J 
NOH - indicates that the file is not in hold status. 
distcode — the file’s distribution code. 
fn ft - the file’s filename filetype. 
dsname - the file’s data set name. 


System Action: None. 


Operator Action: None. 


DMTCMX664E FILE *spoolid’ NOT FOUND 


Explanation: This message is issued in response to a QUERY FILE 
*spoolid’ command. The file identified by *spoolid’ could not be 
found by RSCS, meaning either that the file is not owned by the 
RSCS virtual machine, or that the file is pending and has not yet 
been accepted by RSCS. 


System Action: None. 
Operator Action: Verify that the spool file ID Was correctly 
typed. If it Was not, retry the command with the correct spool 


file ID. If it Was correctly typed, retry the command after some 
time has elapsed to allow the file to move from pending to enqueued 


status. ) 
DMTCMX665I NO FILE ACTIVE 

Explanation: This message is issued in response to a QUERY 

"linkid’ ACTIVE command. At the time of QUERY command processing, 

no file Was being actively transmitted on the specified link. 


System Action: None. 


Operator Action: None. 


DMTCMX666I FILE "’spoolid’ FL ffff FLO nn MO mmmm CH cccc FCB bbbb 


Explanation: This message, in addition to message DMTCMX663I, is 
issued in response to the RSCS command ‘QUERY FILE spoolid VM’ if 
the file contains any 3800 attributes. The 3300-related attributes 
of the file identified by "spoolid’ are described. 


ff*ff - The file’s 3800 forms overlay name 

nn - The file's 3800 forms overlay count 

mmmm ~ The file's 3800 copy modification module name 

cccc - The file’s 3800 character arrangement table name 

bbbb - The file’s 3800 FCB name J 
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System Action: None. 


Operator Action: None. 


DMTCMX6701 LINK 'linkid’ {CONNECT|ACTIVE} -—- ‘type’ LINE "vaddr’ {HO|NOH} 
{DR|NOD} {NOT|TRS|TRL|TSL} 


Explanation: This message iS issued in response to a QUERY SYSTEM 
command, or to a QUERY SYSTEM ACTIVE command. One such message is 
produced for each active link in the RSCS facility at the time of 
command processing. The active link described by the message is 
identified by "linkid’. The CONNECT keyword indicates that the 
line driver successfully received a satisfactory response from the 
remote station on the last attempted exchange. The ACTIVE keyword 
implies that the line driver's last attempted exchange failed due 
to line or remote system failure, or that local telecommunications 
equipment has not been dialed or is not properly set. 


type - the name of the line driver in use by the active link. 

vaddr - the virtual device address of the line port in use by 
the active link. 

HO - indicates that the active link is in hold status. 

NOH - indicates that the active link is not in hold status. 

DR - indicates that the active link is in the process of 
draining, and will terminate when line activity is 
guiesced. 

NOD - indicates that the active link is not in the process of 
draining. 

NOT - indicates that no trace option is active for the link. 

TRS - indicates that the trace sum option is active for the 
link, and that the trace log option is inactive. 

TRL - indicates that the trace log option is active for the 
link, and that the trace sum option is inactive. 

TSL - indicates that both the trace sum and trace log options 


are active for the link. 


System Action: This message is issued for each active link in the 
system. 


Operator Action: None. 


DMTCMX6711I LINK *linkid’ INACTIVE -— DEFAULT ‘type’ LINE ‘'vaddr’ 


Explanation: This message is issued in response to a QUERY SYSTEM 
command. One such message is produced for each inactive link in 
the RSCS facility at the time of command processing. The inactive 
link is identified by "linkid’, it"*s default line driver type is 
identified by ‘type’, and it’s default line port virtual address is 
identified by '"vaddr’. 


System Action: This message is issued for each inactive link in 
the system. 
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DMTCMX6721 


DMT CMX673I1 


DMTCMX6741 


DMTCMX675E 


Operator Action: None. 


NO LINK ACTIVE 

Explanation: This message is issued in response to a QUERY SYSTEM 
ACTIVE command. RSCS had no active link at the time of command 
processing. 


System Action: None. 


Operator Action: None. 


NO LINK DEFINED 
Explanation: This message is issued in response to a QUERY SYSTEM 


command. RSCS had no link defined at the time of command 
processing. 


System Action: None. 


Operator Action: None. 


NO FILES QUEUED 
Explanation: This message is in response to a QUERY SYSTEM QUEUE 
command. No files were active, and no files Were queued or pending 


in the RSCS input file queue at the time of the command processing. 


System Action: None. 


Operator Action: None. 


EXEC "filename" NOT FOUND ON DISK ‘vaddr’* == COMMAND FILE NOT 
EXECUTED 


Explanation: An attempt was made to execute the RSCS operator 
command exec file identified by "filename’. The exec file was not 
found on the RSCS system disk identified by "vaddr’. 


System Action: EXEC command processing is suppressed, the EXEC 
command has no effect, and normal processing continues. 


Operator Action: Verify that the filename was correctly entered on 
the EXEC command line, and that the specified exec file has a 
filetype of "RSCS"’. If an error is found, retry the EXEC command. 
If no error is found and the condition persists, notify local RSCS 
support personnel. 
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DMT CMX676E 


DMTCMX677E 


DMT CMX678E 


DMTREX6791 


FATAL ERROR READING FROM ‘'vaddr’ -- EXEC *filename’ PROCESSING 
TERMINATED 


Explanation: In the process of executing the RSCS exec file 
identified by ‘filename’, an uncorrectable I/0 error was 
encountered in reading the file from the RSCS system disk 
identified by "*vaddr'’. 


System Action: EXEC command processing is terminated at the point 
of error. 


Operator Action: Retry the command if appropriate. If the error 
condition persists, notify local RSCS support personnel. 

EXEC *filename’ FILE FORMAT INVALID -= EXEC NOT EXECUTED 
Explanation: An attempt was made to execute the RSCS operator 
command exec file identified by 'filename'. In the process of 
reading the file from the RSCS system disk, an invalid file format 


Was encountered. 


System Action: EXEC command processing is terminated at the point 
of error. 


Operator Action: Verify that the EXEC command filename was 
correctly specified. If appropriate, retry the command. If the 
error condition persists, notify local RSCS support personnel. 


EXEC 'filename' IN EXECUTION —-— NEW EXEC COMMAND IGNORED 


Explanation: While executing commands from the RSCS exec file 
identified by "filename’, another EXEC command was encountered. 


system Action: The subsequent EXEC command processing is 
suppressed, and the original EXEC command processing continues. 


Operator Action: Notify local RSCS support personnel. 


EXECUTING 'filename’® COMMAND: (command line) 


Explanation: The RSCS command included in the message as (command 
line) has been read from the RSCS exec file identified by 
"filename’', and will be executed. 


System Action: The specified command is executed, and EXEC command 
processing continues. 


Operator Action: None. 
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DMTCMY700I ACTIVATING LINK ‘*linkid’® ‘task’* ‘type’* 'vaddr'’ ‘'c’ 


Explanation: The link identified by ‘linkid’ was inactive and has 
become active as a result of command processing. The message 
describes the variable attributes in effect for this active link. 


task ~ the task name associated With the activated link'’s line 
driver. 
type —- the name of the line driver in use by the activated link. 


vaddr — the virtual device address of the line port in use by the 
activated link. 

c —- the class or classes of files that can be processed by the 
activated link. 


System Action: The activated link remains active, and the listed 
attributes remain in effect, until the link is deactivated or the 
attributes are explicitly modified. The link is activated whether 
or not a line connection is complete to the remote location. 

Active exchange of files, commands, and messages will begin as soon 
as the remote station has been appropriately initialized and the 
data line has been established. 


Operator Action: None. 


| DMTCMY701E NO SWITCHED LINE AVAILABLE —~- LINK *linkid*® NOT ACTIVATED 


Explanation: An attempt Was made to activate the link identified 
by ‘'linkid’ with no specified line port virtual device address. 
The link had no defined default line port address, and no common 
switched line ports were available at the time of command 
processing. 


System Action: The command processing is terminated, the link 
remains inactive, and normal processing continues. 


Operator Action: Retry the command with a specified line port 
address, or retry it When a common switched line port becomes 
available. 


DMTCMY702E LINE *vaddr’ IS IN USE BY LINK *linkidl’® =—— LINK "linkid2’* NOT 
ACTIVATED 


Explanation: An attempt was made to activate the link identified 
by "*linkid2’. The line port virtual device address specified in 
the request to activate the link, identified by ‘vaddr’, was found 
to be in use by another active link, identified by "linkidl’, at 
the time of command processing. 


System Action: Command processing is terminated, the command has 
no effect, and normal processing continues. 
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DMTCMY703E 


DMT CMY 704E 


DMT CMX705E 


Operator Action: Retry the command with a specified line port 
address not in use by another active link; or retry it with no line 
port address specified, in which case RSCS will try to reserve and 
utilize a valid line port. 


DEV *cuu’ IS NOT A LINE PORT -— LINK ‘linkid’® NOT ACTIVATED 


Explanation: An attempt Was made to activate the link identified 
by 'linkid’ with a line port address identified by ‘cuu’. A 
virtual device at address ‘cuu’ exists, but it is not a usable line 
port type device. 


System Action: Command processing is terminated, the link remains 
inactive, and normal processing continues. 


Operator Action: Retry the command with a specified line port 
address that is valid and available; or retry it with no line port 
address at all, in which case RSCS will try to select and reserve a 
common switchable line port. 


LINE "*vaddr’ CC=3 NOT OPERATIONAL —-— LINK *linkid’ NOT ACTIVATED 


Explanation: An attempt was made to activate the link identified 
by "linkid’® with a line port address identified by *vaddr’. Either 
no device was defined for the RSCS virtual machine at virtual 
address ‘vaddr’, or the device at that address was logically 
disconnected from the I/0 system. 


System Action: Command processing is terminated, the link remains 
inactive, and normal processing continues. 


Operator Action: Retry the command With a specified line port 
address that is valid and operational; or retry it With no line 
port address at all, in which case the system will try to select 
and reserve a common switchable line port. 


DRIVER "type" NOT FOUND ON DISK 'vaddr’ -—— LINK ‘linkid’ NOT 
ACTIVATED 


Explanation: An attempt was made to activate the link identified 
by "linkid’ using a line driver name of ‘type’. The specified line 
driver was not found on the RSCS system disk. 


System Action: Command processing is terminated, the link remains 
inactive, and normal processing continues. 


Operator Action: Verify that the driver name used was correctly 
typed. If it was not, retry the command with a corrected line 
driver type specification. If the command was correctly typed, 
notify local RSCS support personnel. Verify that the intended line 
driver resides on the RSCS system disk with a filename of ‘type’ 
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DMT CMY7O06E 


DMT CMX707E 


DMTCMY708E 


and a filetype of "TEXT’. 


FATAL ERROR LOADING FROM ‘'vaddr’*® -—-— LINK *linkid* NOT ACTIVATED 


Explanation: An attempt was made to activate the link identified 
by "linkid'. In the process of loading the link’s line driver from 
the disk identified by "vaddr’, an uncorrectable I/O error was 
encountered. 


system Action: Loading iS abandoned, the error is logged, the 
command processing 15 terminated, and the link remains inactive. 


Operator Action: Retry the command. If the error condition 
persists, notify local RSCS support personnel. 


DRIVER ‘type’ FILE FORMAT INVALID -—-— LINK "linkid* NOT ACTIVATED 


Explanation: An attempt was made to activate the link identified 

by *linkid’, with a line driver type specification of ‘type’. In 

the process of reading the driver file and loading the driver into 
virtual storage, the loader detected an invalid data format in the 
driver file. 


System Action: Loading is abandoned, the command processing 15 
terminated, and normal processing continues. 


Operator Action: Verify that a correct line driver type 
specification has been used. If an improper driver type was used, 
retry the command with a correct driver type specification. If the 
proper driver type was used, notify local RSCS support personnel. 


VIRTUAL STORAGE CAPACITY EXCEEDED =—— LINK "'linkid’® NOT ACTIVATED 


Explanation: An attempt Was made to activate the link identified 
by ‘linkid’. During the activation process, a virtual free storage 
requirement could not be met because there was insufficient virtual 
storage available for allocation by RSCS. 


System Action: Command processing is terminated, the link remains 
inactive, and normal processing continues. 


Operator Action: Retry a START command later, when more virtual 
storage may be available. Deactivating another link Will increase 
available virtual storage. If this situation occurs regularly, it 
might be corrected by increasing the size of the RSCS virtual 
machine’s virtual storage prior to RSCS IPL. 
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DMT CMX709E 


DMT CMX710E 


DMT xxx750E 


DMTCMY751I 


TASK NAME "task’ ALREADY IN USE -- LINK ‘"linkid’ NOT ACTIVATED 


Explanation: An attempt to activate the link "linkid’, in response 
to a START command, failed because the task name ‘task’* specified 
for use was in use by another task in the system. 


System Action: The START command is suppressed, and normal 
processing continues. 


Operator Action: Retry the START command specifying a different 
task name by use of the '*TASK’ keyword, or retry the START command 
after the line driver with the conflicting task name has been 
deactivated. 


MAX C¥nn*) ACTIVE ==} LINK "linkid’~ NOT ACTIVATED 
Explanation: An attempt to activate the link ‘linkid’, in reponse 
to a START command, failed because the maximum allowable number 


*nn’ of concurrent active links had already been reached. 


system Action: The START command is ignored, and normal processing 
continues. 


Operator Action: Retry the START command after one or more links 
have been deactivated. 

LINK "linkid’® ALREADY ACTIVE --— NO ACTION TAKEN 

Explanation: A START command was issued specifying the link 
identified by "linkid’. The link Was already active at the time of 
command processing, and no modifiable attributes were changed from 


their previous settings. 


system Action: The START command is ignored, and normal processing 
continues. 


Operator Action: None. 


LINK "linkid’ ALREADY ACTIVE -— NEW CLASS(ES) SET AS REQUESTED 
Explanation: A START command was issued specifying the link 
identified by "linkid’. The link was already active at the time of 
command processing, and the new class specification for the link 


has been accepted. 


System Action: The link begins processing files bearing the newly 
specified class(es) if any are enqueued on the link. 


Operator Action: None. 
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DMT xxx752I 


DMTxxx801I 


DMT xxx802I 


DMT xxx803] 


LINK "linkid’® STILL ACTIVE -— DRAIN STATUS RESET 


Explanation: A START command was issued specifying the link 
identified by "linkid’®. The link was active at the time of command 
processing, but it was in the process of terminating as the result 
of a previous DRAIN command. 


System Action: The link remains active with the same attributes 
that had previously been in effect, except that the link’s drain 
status is reset. Normal RSCS processing continues. 


Operator Action: None. 


LINK *linkid’ LOG ACTIVATED 


Explanation: This message is issued in response to a TRACE 
*linkid*’ LOG command. The specified link’s log trace had been 
inactive prior to command processing, and now has been activated. 


system Action: While log trace is active for a link, a record of 
each line I/O transaction is written to a spool print file. Each 
record contains the channel program executed, the composite CSHh, 
the ending sense data if any, and the beginning and ending data 
string from each buffer used. The spool file is queued for real 
printer output when the log trace is deactivated for the link. 


Operator Action: None. 


LINK *linkid’ LOG DEACTIVATED 


Explanation: This message is issued in response to a TRACE 
"linkid’ NOLOG command. The specified link’s log trace had been 
active prior to command processing, and now has been deactivated. 


System Action: Logging of each line 1/0 transaction is terminated, 
and the spool print file log of prior transactions is closed and 
enqueued-for real printer processing. 


Operator Action: This function provides system support personnel 
With diagnostic information concerning telecommunication system 
behavior. When communication on a particular link appears to be 
malfunctioning, prepare a log trace and submit it to the local 
support personnel. 


LINK *linkid’ SUM REPORTING DEACTIVATED 


Explanation: This message is issued in response to a TRACE 
7linkid* NOSUM command. The specified link had been in sum trace 
mode prior to command processing, and has now left sum trace mode. 
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System Action: No further sum trace messages Will be issued, and 
normal link processing continues. 


Operator Action: None. 


DMTxxx8l0E LINK *linkid*® LOG ALREADY ACTIVE 


Explanation: This message is issued in response to a TRACE 
"linkid*’ LOG command. The command requested that the specified 
link enter log trace mode, and the link had already been in log 
trace mode at the time of command processing. 


System Action: The link remains in log trace mode, the command has 
no effect, and normal link processing continues. 


Operator Action: None. 


DMTxxx8llE LINK *linkid’*® LOG NOT ACTIVE 


Explanation: This message is issued in response to a TRACE 
*linkid*’ NOLOG command. The command requested that the specified 
link leave log trace mode, and the link had not been in log trace 
mode at the time of command processing. 


System Action: Log trace remains inactive for the link, the 
command has no effect, and normal link processing continues. 


Operator Action: None. 


DMTxxx81l2E LINK *linkid*® SUM REPORTING ALREADY ACTIVE 


Explanation: This message is issued in response to a TRACE 
"linkid’ SUM command. The command requested that the specified 
link enter sum trace mode, and the link had already been in sum 
trace mode at the time of command processing. 


System Action: The link remains in sum trace mode, the command has 
no effect, and normal link processing continues. 


Operator Action: None. 


DMTxxx313E LINK "*linkid’ SUM REPORTING NOT ACTIVE 


Explanation: This message is issued in response to a TRACE 
*linkid* NOSUM command. The command requested that the specified 
link leave sum trace mode, and the link had not been in sum trace 
mode at the time of command processing. 


System Action: Sum trace remains inactive for the link, the 
command has no effect, and normal link processing continues. 
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Operator Action: None. 


DMTSMLOOLE INVALID SML MODE SPECIFIED —-— LINK ‘*linkid’ NOT ACTIVATED 


Explanation: During initial processing immediately following link 
activation, the line driver encountered an invalid mode 
specification. 


System Action: The specified link is deactivated. 


Operator Action: Retry the START command, specifying a valid mode. 
If the problem persists, notify local RSCS support personnel. 


DMTxxx902E NON—-SIGNON CARD READ ON LINK ‘linkid’ 


Explanation: The link identified by "linkid’ had not been signed 
on, and a record received from the remote station was not a SIGNON 
record contrary to line driver operational requirements. 


System Action: The link remains active but not signed on, and 
file, command, and message exchange for the link remains suspended 
pending successful sign-on. 


Operator Action: Correct any errors present on the sign-on card, 
and retry the sign-on procedure. 


DMTxxx903E PASSWORD SUPPLIED ON LINK ‘linkid’® IS INVALID 


Explanation: An attempt to sign-on a remote station has failed 
because the password entered on the SIGNON record does not match 
the password specified by the operator when the remote station’s 
link, identified by ‘*linkid’, was started. 


System Action: The link remains active but not signed on, and 
file, command, and message exchange for the link remains suspended 
pending successful sign-on. 


Operator Action: Correct any errors present on the SIGNON record 
and retry the sign-on procedure. If the problem persists, the 
operations personnel at both ends of the link should establish an 
agreed upon password. 


DMTxxx904E SIGNON PARAMETER=‘parm’ ON LINK ‘*linkid’ INVALID 


Explanation: A sign-on record for the link identified by "linkid’ 
contained the invalid parameter identified by ‘parm’. 


System Action: The link remains active but not signed on, and 


file, command, and message exchange for the link remains suspended 
pending successful sign-on. 
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c 


| DMTxxx9051 


DMT xxx9O06E 


DMTNPT9O7E 


DMTxxx9 038E 


Operator Action: Correct any errors present on the sign-on card 
and retry the sign-on procedure. 


SIGNON OF LINK ‘*linkid' COMPLETE [,BUFFSIZE='nnnn'] 


Explanation: A valid SIGNON record has been received on the link 
identified by "linkid’, and the link sign-on procedure has been 
successfully completed. When issued by the DMTNJI line driver 
task, nnnn specifies the TP buffer size selected. 


System Action: Exchange of files, commands, and messages iS begun 
on the identified link. 


Operator Action: If the remote station is a bulk terminal, follow 
normal operational procedures for sending input files and receiving 
output files. 

INVALID BUFFER PARAMETER -—-— LINK "linkid’ NOT ACTIVATED 
Explanation: During initial processing immediately following link 
activation, the line driver encountered an invalid buffer 
specification. 

System Action: The specified link is deactivated. 

Operator Action: Retry the START command, specifying a valid 
buffer request. If the problem persists, notify local RSCS support 
personnel. 


SIGNON TYPE PARAMETER MISSING 


Explanation: The sign-on record previously entered did not include 
a TYPE parameter specifying the type of remote terminal in use. 


System Action: The link remains active but not signed on, and 
file, command, and message exchange for the link remains suspended 
pending successful sign-on. 

Operator Action: Correct any errors present on the sign-on card, 
include the TYPE parameter on the sign-on card, and retry the 
sign-on procedure. 

INVALID "PARM* PARAMETER "parmvalue’ SPECIFIED 

Explanation: During initial processing immediately following link 
activation, the line driver encountered an invalid parameter 


specification. 


System Action: The specified link is deactivated. 
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DMTNHD9Y1OE 


DMTNIT9IIIE 


DMTNIT912E 


DMTxxx913E 


Operator Action: Retry the START command, specifying a valid PARM 
parameter request. If the problem persists, notify local RSCS 
Support personnel. 


INVALID NJI PARAMETER *parm* ON TAG —— PARAMETER IGNORED 
Explanation: In the scanning of file tag specified by the local 
originating user, an invalid parameter identified by "parm’ was 


encountered. 


System Action: The invalid parameter is ignored, its applicable 
default applies, and file processing continues. 


Operator Action: None. 


INVALID NJI BUFFER SIZE SPECIFIED —— LINK *%linkid’® NOT ACTIVATED 


Explanation: During initial processing immediately following link 
activation, the line driver encountered an invalid buffer size 
request. 


System Action: The specified link is deactivated. 
Operator Action: Retry the START command, specifying a valid 


buffer size. If the problem persists, notify local RSCS support 
personnel. 


INVALID NJI NODAL RESISTANCE SPECIFIED =— LINK *linkid’ NOT 
ACTIVATED 


Explanation: During initial processing immediately following link 
activation, the line driver encountered an invalid nodal resistance 
specification. 

system Action: The specified link is deactivated. 

Operator Action: Retry the START command, specifying a valid nodal 
resistance. If the problem persists, notify local RSCS support 
personnel. 

INVALID PASSWORD PARAMETER SPECIFIED —— LINK "linkid’ NOT ACTIVATED 
Explanation: During initial processing immediately following link 
activation, the line driver encountered an invalid password 


specification. 


System Action: The specified link is deactivated. 
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DMT xxx91GE 


DMTNCM916E 


DMTNHD9171 


Operator Action: Retry the START command, specifying a valid 
password. If the problem persists, notify local RSCS support 
personnel. 


INCORRECT PASSWORD RECEIVED ON LINK ‘linkid’ 


Explanation: A valid password parameter received in a SIGNON 
record from the remote system did not match the local link password 
in effect at the time. 


System Action: The line driver executes its disconnect sequence. 
Depending on the line driver in use, the line may be re-enabled or 
the link may be deactivated. 


Operator Action: Notify system support personnel at the remote 
location. If the problem persists, notify local RSCS support 
personnel. 


INVALID NJI SIGNON CONNECTION RECORD RECEIVED —-— LINK ‘linkid’ IS 
BEING DEACTIVATED 


Explanation: An invalid sign-on record has been received from the 
remote station. 


System Action: The affected line driver executes its disconnect 
procedure, and the link is deactivated. 


Operator Action: Notify local RSCS support personnel. 


NJI LINK ‘linkid’: {JOB | OUTPUT} C’orgid’), JOBNAME *job*, PGMR 
user’ 


Explanation: ThiS message 1s issued each time the NJI line driver 
for the active link identified by "linkid’ encounters a job header 
record in the data stream being received from the remote system. 
The job header defines the beginning of a job or job output in the 
data stream being received. The substitution parameters in the 
message specify the following: 


JOB - denotes the beginning of reception of a job file. 

OUTPUT - denotes the beginning of reception of a job output file. 

orgid - identifies the job file’s origin spool ID or job number. 

job - identifies the job name of the job or output file being 
received. 

user - identifies the originating user's programmer name or 
user ID. 


System Action: The job or output file is written to the VM/370 
spool system as it is received, and it is forwarded to the next 
link on its path, delivered to a local user, or processed on a 
local real spool output device, depending on its destination 
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address. 


Operator Action: None. 


DMTxxx913E LINK "*linkid*® DOES NOT MATCH REMOTE LOCATION *locid’ 


Explanation: A SIGNON record received from the remote system 
specified a location ID ‘locid’ which was not the same as the link 
ID *linkid’ for the line driver in use at the local location. The 
link ID is defined as the location ID of the directly connected 
remote location. 


System Action: The line driver executes its disconnect sequence. 
Depending on the line driver in use, the line may be re-enabled or 


the link may be deactivated. 


Operator Action: Notify local RSCS support personnel. 


DMTxxx919E SIGNON SEQUENCE ON LINK ‘linkid’ FAILED 


Explanation: 


e Data was received from the remote system before a SIGNON record 
was successfully received and accepted, 


e¢ An unrecoverable line error occurred during sign-on sequence, 


e An incorrect password or location ID was detected at the remote 
system, or 


¢ The remote system is incompatible With the line driver in use. 
System Action: The line driver executes its disconnect sequence. 
Depending on the line driver in use, the line may be re-enabled or 
the link may be deactivated. 
Operator Action: Notify local RSCS support personnel. 

DMTRPT921I PRINTER ON LINK *linkid’ LINE "°vaddr’® DISABLED —- INTERVENTION OR 
MAINTENANCE REQUIRED 
Explanation: A printer described by "linkid’® and ‘'vaddr' detected 
an I/O error condition While a file was printing. Any further 
action has to be initiated by the operator 
System Action: The line driver tries to resend the print buffer 


three times. On the third try, the message is printed and the line 
driver waits for operator intervention. 
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Operator Action: HOLD the link, then FLUSH the file with any 
option desired. When the file is purged or re-enqueued, the link 
can be DRAINed and restarted. If I/0 errors persist, call your 
local customer engineer. 


| DMTRPT92Z22I INTERVENTION REQUIRED ON PRINTER LINK ‘linkid’® LINE ‘vaddr’ 


Explanation: A printer described by ‘linkid’® and ‘vaddr’" needs 
| operator intervention. 
System Action: The line driver tried to make the initial 
connection or send a print buffer to a non-working printer. The 
line buffer waits for operator intervention on the device or 
console command execution. 


Operator Action: Turn the printer on, fix printer paper, or enter 
the console commands to DRAIN the link or FLUSH the file. 


DMTRPT923E LINE OR CHANNEL I/O ERROR —— MAINTENANCE REQUIRED ON LINK ‘linkid’ 
LINE *vaddr'‘ 


Explanation: A printer described by ‘linkid’ and ‘'vaddr’ detected 
an 1/0 error condition while a file was printing. Any further 
action has to be initiated by the operator. 


ten times. On the tenth try, the message is printed and the line 
driver terminates. 


Operator Action: HOLD the link,, then FLUSH the file with any 
option desired. When the file is purged or re-enqueued, the link 
can be DRAINed and/or restarted. If I/O errors persist, call 


System Action: The line driver tries to resend the print buffer 
your local customer engineer. 


| DMTRPT924E NONRECOVERABLE PROGRAM ERROR ON LINK ‘linkid’ LINE ‘vaddr’ 


Explanation: A printer described by ‘linkid’ and ‘vaddr’ detected 
an I/0 error condition while a file was printing. 


System Action: The line driver tried to send the print buffer but, 


because of a non-recoverable hardware programming error, an 1/0 
error message is produced and the line driver ends. 


Operator Action: If I/0 errors persist, call your local customer 
engineer. 
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DMTRPT9251 


DMT xxx934¢E 


DMTSML9O35E 


DMTNPTS36E 


FILE PURGED BY USER ON PRINTER ‘%linkid’ LINE ‘vaddr’ 


Explanation: On the printer described by ‘linkid’ and ‘vaddr’, the 
user raised the cover three times (with the same print buffer), 
Which caused the line driver to purge the file. 


System Action: Every time the printer cover is lowered, the line 
driver tries to resend the print buffer. On the third try the file 
is purged and the message is sent to the user who sent the file. 


The line driver then prints the next file in the queue or waits for 
one to be enqueued. 


Operator Action: None. 


ID CARD MISSING ON LINK *linkid* —-— INPUT FILE PURGED 


Explanation: A file has been entered at a remote station without 
an ID card specifying the destination. 


System Action: The input file is flushed, and normal processing 
continues. 


Operator Action: Place an ID card at the beginning of the input 
file deck, or correct errors in an existing ID card, and retry the 
file input operation. Consult operational procedures for the 
remote terminal and line driver in use to determine format 
requirements for the input file ID card. 

LINK "linkid’® IN RJE MODE -—— PRINT FILE ‘spoolid’ PURGED 
Explanation: An attempt Was made to transmit a print file ona 
link Which WasS operating as a workstation submitting jobs to a 
remote batch system. When operating in this mode, print file 


cannot be transmitted. 


System Action: The specified file is purged. 


Operator Action: None. 


NO REMOTE PUNCH AVAILABLE ON LINK ‘linkid’ -=—= FILE "*spoolid® PURGED 


Explanation: An attempt was made to transmit a punch file to a 
remote terminal which was not equipped to produce punched output. 


System Action: The specified file is purged. 


Operator Action: None. 
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DMTxxx937E DECOMPRESSION ERROR ON LINK ‘linkid’ 

Cc Explanation: Ina multi-leaving line driver, DMTSML or DMTNJI, an 
SCB has been encountered in a record that, when expanded, causes 
the record to overflow the length of a ‘tank’ (an intermediate 
processing buffer). This error has occurred because of invalid 
input sent by the remote system, or because of errors on the 
transmission line. 

| System Action: The affected line driver is deactivated. 
Operator Action: Retry. If the error recurs, notify local RSCS 
support personnel. 

DMTPOWS940E LINK ‘*linkid* IN POWER MODE — PRINT FILE ‘spoolid’ PURGED 

Explanation: An attempt was made to transmit a print file on a 
link which was operating as a workstation submitting jobs to a 
remote VSE/POWER batch system. When operating in this mode, print 
files cannot be transmitted. 


System Action: The specified file is purged. 


Operator Action: None. 


Cow DMTPOWSG1E LINK "linkid’* INVALID "CMD" SPECIFICATION 
Explanation: No command text was entered for the CMD command. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command. 


DMTPOW942E LINK *linkid’ POWER COMMAND SPECIFIED INVALID OR NOT SUPPORTED 


Explanation: The VSE/POWER command specified is invalid or not 
supported. 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command if it was incorrect. 


DMTPOWS43E LINK ‘linkid’ POWER COMMAND OPERAND SPECIFIED INVALID OR NOT 


SUPPORTED 
Explanation: A supported VSE/POWER command was recognized, but the 
( subsequent operands specified were found invalid or not supported. 
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DMTP OW9441 


DMTPOWS451 


DMT P OWS 46E 


System Action: The command is ignored, and normal processing 
continues. 


Operator Action: Retry the command. 


POWER COMMAND FROM ‘linkid’ IGNORED: (command text) 

Explanation: The character string included in the message as 
command text has been received from the remote VSE/POWER location 
identified by "linkid’. 


System Action: Normal RSCS processing continues. 


Operator Action: None. 


LINK "linkid*® DEACTIVATION INITIATED BY POWER 


Explanation: The link identified by "linkid’ was deactivated as a 
result of the execution of a PSTOP or PEND command in the VSE/POWER 
system. 


System Action: The link’s line driver task is deleted, all storage 
allocated to the task is made free, and the link table entry is 
updated. The link remains inactive until it is reactivated by a 
START command. 

Operator Action: To reestablish connection, restart the link using 
the START command. 


INVALID POWER CPUID SPECIFIED —— LINK ‘linkid’ NOT ACTIVATED 


Explanation: The global remote CPU ID entered was not a value 
between 1 and 200. 


System Action: The specified link is deactivated. 


Operator Action: Reissue the START command specifying a valid 
CPUID parameter. 


RSCS MESSAGE SUMMARY 


The key to the left of the message identifiers indicates the possible 
destinations of each message; the keys are: 


R — RSCS local operator’s console 
O — Command originator 
V —- Virtual machine user 


C = VM/370 CP operator 
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SPONTANEQUS MESSAGES 


Da DDD DA 


aD WD D7 


7~ 


DMTIRXOOOI 


DMTCMXOO1I 
DMTREXOO02I1 
DMTCMXO003I 
DMTCMX004I1 
DMTCMXOOS5I 


DMT xxxO7O0E 


DMTREXO80E 
DMTREXO9OT 


DMTREXO91T 


DMTAXM1011 
DMTAXM1021 
DMT AXM1OSE 


DMTAXM1 041 


DMTAXM1 051 
DMTAXM1 061 


DMTAXM1071 
DMT xxx1lO8E 
DMT AXM1 091 
DMTAXMI11E 


DMT xxx141I1 
DMT xxxl42I1 
DMT xxx143I 
DMT xxx144I 


DMT xxx145I 


DMT xxx146I1 


DMT xxx147I 


DMTxxx148I 


DMT xxx149I1 


DMTxxx160I1 


DMTxxx170I 


DMTxxx171I 


DMTCMX1721 


DMT xxx190E 
DMTIRX4001 


RSCS NETWORKING VERSION vv, RELEASE nn, mm/dd/yy 
READY 

FREE STORAGE = 'nn" PAGES 

LINK "*linkid’® DEACTIVATED 

LINK "linkid’ EXECUTING: (command line text) 
LOCATION "locid' EXECUTING: (command line text) 
LOCATION ‘locid’(’userid’) EXECUTING: 


(command line text) 


I/O ERROR cuu SIOCC cc CSW csw SENSE sense 


CCW ccw 

PROGRAM CHECK —— LINK ‘linkid’® DEACTIVATED 
PROGRAM CHECK IN SUPERVISOR ~—- RSCS NETWORKING 
SHUT DOWN 

INITIALIZATION FAILURE —-—- RSCS NETWORKING 

SHUTDOWN 

FILE *spoolid’ (C’orgid’') ENQUEVED ON LINK ‘linkid’ 
FILE "spoolid’ (’orgid') PENDING FOR LINK ‘linkid’ 
FILE "*spoolid’ ('’orgid’) REJECTED -— INVALID 
DESTINATION ADDRESS 

FILE (*orgid’) SPOOLED TO *useridl’ -—— ORG 'locid’ 
Cuserid2) mm/dd/yy hh:mm:ss 

FILE *spoolid’ PURGED 

FILE *spoolid’ MISSING —— DEQUEUVUED FROM LINK 
*linkid’ 

*nn*® PENDING FILES FOR LINK ‘*linkid’® MISSING 
SYSTEM ERROR READING SPOOL FILE ‘'spoolid’ 

FILE QUEUE REORDERED 

USER *userid® NOT IN CP DIRECTORY =-— FILE ('orgid’®) 


SPOOLED TO SYSTEM 
LINE *vaddr"* READY FOR CONNECTION TO LINK "linkid’ 


LINK *"linkid® LINE ‘vaddr’* DATASET READY 

LINK "’linkid’® LINE *vaddr’" DISCONECTED 
RECEIVING FILE (¢’*’orgid’) ON LINK 'linkid’® FROM 
"locid’ (*’userid’), REC nnnnnnnn 

RECEIVED FILE (*%orgid’) ON LINK ‘*linkid’ TO 
*locid’ ‘userid’ 

SENDING FILE ‘*spoolid’® (’orgid’) ON LINK FROM 
*locid’ ‘userid’ 

SENT FILE 'spoolid’® (’orgid’) ON LINK ‘linkid’® TO 
*locid’ ‘userid’ 

ACTIVE FILE *spoolid® SENDING RESUMED ON LINK 
*linkid’ 

LINK "linkid’® LINE ACTIVITY: TOT= mmmmmmmm; 
ERRS= nnnnnnnn; TMOUTS= pppppppp 

LINE *vaddr’® DISABLED FOR ‘"linkid’ 

FROM *linkid’: (message text) 

FROM *linkid’(*’userid’): (message text) 

CPQ: (command response) 


INVALID SPOOL BLOCK FORMAT ON FILE 
RSCS DIRECT mm/dd/yy hh:mm,*nn’* MAX 
ACTIVE LINKS, ‘tt’ TAGS 


*spoolid’ 
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R — RSCS local operator's console 
0 — Command originator 
V = Virtual machine user 
C — VM/370 CP operator 


Spontaneous Messages (Continued) 


R 


COMMAND 


General 


oo ao ao ao aooo0oo0o90g0o oa 


5B-68 


DMTxxx580I 
DMTNHDII1OE 


DMTNHD9171 


DMTRPT9211 


DMTRPT9221 


DMTRPT9Z3E 


DMTRPT92Z4E 


DMTRPT9251 


DMT xxx93G4E 


DMTSML9OSS5E 


DMT NP T936E 


DMTPOWS40E 


DMTPOWS44I 


DMTPOWS45I 


RESPONSES 


DMTCMX200I 
DMTCMX201E 
DMT CMX202E 
DMTCMX203E 
DMT CMX204E 
DMTCMX205E 
DMT CMX206E 
DMTCMX207E 
DMTCMX208E 
DMTCMX209E 
DMTCMX2190E 
DMT xxx3 001 
DMTxxx301E 


FILE "Spoolid’ PROCESSING TERMINATED 
INVALID NJI PARAMETER ‘parm’ ON TAG —--— 
PARAMETER IGNORED 

NJI LINK ‘'linkid’: {JOB | OUTPUT} ("orgid"), 
JOBNAME "Jjob’, PGMR ‘user’ 

PRINTER ON LINK ‘'linkid’ LINE "‘vaddr’ DISAB 
INTERVENTION OR MAINTENANCE REQUIRED 
INTERVENTION REQUIRED ON PRINTER LINK ‘link 
LINE "vaddr'’ 

LINE OR CHANNEL I/O ERROR —— MAINTENANCE 
REQUIRED ON LINK ‘linkid’ LINE "vaddr’ 
NONRECOVERABLE PROGRAM ERROR ON LINK ‘"linki 
LINE ‘vaddr' 

FILE PURGED BY USER ON PRINTER ‘linkid'’ 
LINE "vaddr' 


ID CARD MISSING ON LINK ‘linkid’ —-— INPUT 
FILE PURGED 

LINK "linkid’ IN RJE MODE —— PRINT FILE 
*spoolid’ PURGED 

NO REMOTE PUNCH AVAILABLE ON LINK ‘linkid’ 


FILE "*spoolid’ PURGED 


LINK *linkid’ IN POWER MODE -—— PRINT FILE ° 
PURGED 
POWER COMMAND FROM LINK ‘linkid’® IGNORED: 


(command text) 
LINK ‘linkid* DEACTIVATION INITIATED BY POW 


Command Responses 


RSCS 

INVALID COMMAND "command’ 

INVALID LINK ‘linkid’ 

INVALID SPOOL ID ‘spoolid’ 

INVALID KEYWORD ‘keyword’ 

CONFLICTING KEYWORD *keyword’ 

INVALID OPTION "keyword’ ‘option’ 
CONFLICTING OPTION keyword’ ‘option’ 
INVALID USER ID ‘userid’ 

RESTRICTED COMMAND *command’ 

INVALID LOCATION ‘locid’ 

ACCEPTED BY TASK ‘task’ 

REJECTED BY TASK ‘'task"* =— PREVIOUS COMMAND 
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LED -- 


id’ 


d’ 


spoolid’ 


ER 


ACTIVE 


C 


R — RSCS local operator's console 
0 - Command originator 
V - Virtual machine user 
C — VM/370 CP operator 


General Command Responses (Continued) 


DMTxxx302E LINK "linkid’ IS NOT DEFINED 
DMTxxx303E LINK "linkid’ IS NOT ACTIVE 


DMTCMX310E LOCATION ‘locid’® IS NOT DEFINED 
DMTxxx320E LINK ‘'linkid’ NOT CONNECTED 
DMTRGX330E USERID MISSING OR INVALID 
DMTRGX331E ‘userid’ NOT LOGGED ON 
DMTRGX332E ‘userid’ NOT RECEIVING 


oa ao 0000 0 O 


wa 
” 


NO ACTION TAKEN 


Specific Command Responses 


DMTxxx30GE REJECTED BY TASK ‘task’ -— NOT RECEIVING 


DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘'linkid’ -— 


BACKSPAC: 
O DMTxxxS10I FILE "spoolid’ BACKSPACED 
O DMTxxx5l1lE NO FILE ACTIVE ON LINK ‘linkid’ 
R,QO DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘"linkid’ -— 
NO ACTION TAKEN 
CHANGE: 
O DMTAXM5201I FILE ‘'spoolid’ CHANGED 
O DMTAXM5211 FILE *spoolid’ HELD FOR LINK ‘linkid’ 
O DMTAXM522I FILE ‘'spoolid’ RELEASED FOR LINK ‘*linkid’ 
O DMTAXMS231I LINK 'linkid’ QUEUE REORDERED 
O DMTAXM524E FILE 'spoolid’ ACTIVE —-- NO ACTION TAKEN 
O DMTAXM525E FILE *spoolid’ IS FOR LINK ‘linkid’ —= 
NO ACTION TAKEN 
O DMTAXM526E FILE *spoolid’ NOT FOUND -— NO ACTION TAKEN 


CLOSE: 


R DMTAXM500I nn FILE(S) CLOSED ON LINK 'linkid’ 
DMTAXMSO1E LINK ‘'linkid’ ACTIVE -— NO FILE(S) 


Pa] 


CLOSED 


R DMTAXM502E FILE '’spoolid’ INACTIVE —~- NO ACTION TAKEN 


CMD: 


DMTxxx302E LINK "linkid’ IS NOT DEFINED 
DMTxxx303E LINK "linkid’ IS NOT ACTIVE 
DMTCMX310E LOCATION *locid’ IS NOT DEFINED 
DMTxxx320E LINK *linkid’ NOT CONNECTED 


oo oo 
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R — RSCS local operator's console 


O = Command originator ) 
V = Virtual machine user | 


C —- VM/370 CP operator 


Specific Command Responses (Continued) 


R,V DMTPOWS41E LINK ‘'linkid*® INVALID "CMD" SPECIFICATION 

R,V DMTPOW942E LINK ‘linkid* POWER COMMAND SPECIFIED INVALID OR 
NOT SUPPORTED 

R,V DMTPOW943E LINK ‘linkid* POWER COMMAND OPERAND SPECIFIED 
INVALID OR NOT SUPPORTED 


DEFINE: 
R DMTCMX540I NEW LINK ‘'linkid*® DEFINED 
R DMTCMX541I LINK ‘%linkid’ REDEFINED 
R DMTCMX542E LINK "linkid’ ACTIVE -— NOT REDEFINED 
R DMTCMX543E LINK "linkid’ NOT DEFINED —-=—= LINK LIMIT REACHED 
R DMTCMX653I LINK ‘'linkid’ DEFAULT ‘task’ ‘type’ "vaddr'’ 
e-Z2e2 ker 
DELETE: 
R DMTCMX550I LINK *linkid’* NOW DELETED 
R DMTCMX551E LINK ‘'linkid’* ACTIVE —-— NOT DELETED ) 
R DMTCMX552E LINK ‘'linkid’® HAS A FILE QUEUE -— NOT DELETED 
DISCONN: 


R DMTCMX560I RSCS NETWORKING DISCONNECTING 
R DMTCMX561E USERID ‘userid*® NOT RECEIVING 


DRAIN: 


R,O DMTxxx570I LINK "linkid’ NOW SET TO DEACTIVATE 
R,O DMTxxx571E LINK ‘*linkid’® ALREADY SET TO DEACTIVATE 


EXEC: 


R DMTCMX675E EXEC ‘filename’ NOT FOUND ON DISK ‘'vaddr’ -— 
COMMAND FILE NOT EXECUTED 

R DMTCMX676E FATAL ERROR READING FROM ‘'vaddr’* =—-— EXEC 
"filename’ PROCESSING TERMINATED 

R DMTCMX677E EXEC 'filename’ FILE FORMAT INVALID —— 
EXEC NOT EXECUTED 

R DMTCMX678E EXEC 'filename’ IN EXECUTION -— NEW EXEC 


COMMAND IGNORED , 
R DMTREX679I EXECUTING *’filename* COMMAND: (command line) 
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0 =— Command originator 
Ve- Virtual machine user 
C — VM/370 CP operator 


R - RSCS local operator's console 


Specific Command Responses (Continued) 


FLUSH: 
R,O DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘linkid’ =-- 
NO ACTION TAKEN 
R,O DMTxxx580I FILE *spoolid’ PROCESSING TERMINATED 
O DMTxxxS81E FILE *spoolid® NOT ACTIVE 


FORCE: 


R DMTREX002I LINK "linkid’ DEACTIVATED 


FREE: 
R,O DMTxxx590I LINK ‘linkid’ RESUMING FILE TRANSFER 
R,O DMTxxx591E LINK ‘linkid’ NOT IN HOLD STATUS 


FWDSPACE: 


O DMTxxx511E NO FILE ACTIVE ON LINK ‘linkid’ 
R,O DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘linkid’ == 
NO ACTION TAKEN 
O DMTxxx600I FILE ‘spoolid’ FORWARD SPACED 


HOLD: 


R,O DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘linkid’® -= 
NO ACTION TAKEN 

DMTxxx610I LINK *linkid’ TO SUSPEND FILE TRANSMISSION 

DMTxxx611I LINK *linkid*® FILE TRANSMISSION SUSPENDED 

DMTxxx612E LINK ‘linkid’ ALREADY IN HOLD STATUS 


m7 7 D7 
oOoo°o 


MSG: 


DMTxxx302E LINK ‘linkid’ IS NOT DEFINED 

DMTxxx303E LINK "*linkid’® IS NOT ACTIVE 

DMTCMX310E LOCATION *locid’ IS NOT DEFINED 

DMTxxx320E LINK "linkid’ NOT CONNECTED 

DMTRGX330E USERID MISSING OR INVALID 

DMTRGX331E "userid’ NOT LOGGED ON 

DMTRGX332E "userid’ NOT RECEIVING 

DMTxxx531I INVALID LINE DRIVER COMMAND FOR LINK ‘linkid’® == 
NO ACTION TAKEN 


ooo 0 0o000 


C 
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R —- RSCS local operator's console 
0 = Command originator 
V- Virtual machine user 
C — VM/370 CP operator 


Specific Command Responses (Continued) 


ORDER: 
R,OQ DMTAXM5231I LINK "linkid® QUEUE REORDERED 
R,Q DMTAXM524E FILE "*spoolid’ ACTIVE -— NO ACTION TAKEN 
R,OQ DMTAXM525E FILE ‘"*spoolid’ IS FOR LINK ‘linkid’ == 
NO ACTION TAKEN 
R,O DMTAXM526E FILE ‘*spoolid® NOT FOUND -— NO ACTION TAKEN 
PURGE: 
R,O DMTAXM5S24E FILE "*spoolid’ ACTIVE --— NO ACTION TAKEN 
R,O DMTAXM525E FILE *spoolid’ IS FOR "linkid’ == 
NO ACTION TAKEN 
R,OQ DMTAXM526E FILE "*spoolid* NOT FOUND == NO ACTION TAKEN 
R,Q DMTAXM640I1 ‘'nn* FILE(S) PURGED ON LINK ‘linkid’ 


QUERY ‘locid': 


DMTCMX637I1I "*locid’ NOT ROUTED 
DMTCMX6511I LINK "linkid’ INACTIVE 


0o0oa0a Oo 


DMTCMX636I1 "locid’ ROUTED THROUGH LINK ‘linkid’ 


5B-72 


DMTCMX652I LINK "linkid’ {CONNECT | ACTIVE} "task" '"type’ 
"'vaddr’? c {HO|NOH}{DR|NOD} {NOT|TRS|TRL|TSL} 

QUERY "linkid’® ACTIVE: 

DMTCMX656I FILE "*spoolid’ C*orgid’) "*locid" "userid’ 
CL a PR pp LEFT mmmmmmmm OF nnnnannnn 

DMTCMX665I NO FILE ACTIVE 

QUERY "linkid’ DEF: 

DMTCMX6531I LINK ‘"linkid’® DEFAULT "task’® ‘type’ ‘'vaddr’' 
c Z=z R=r 

QUERY "linkid’ FILES: 


DMTCMX654I1 LINK ‘linkid’ S=s R=r Q=q P=p 


QUERY "linkid’® QUEUE: 
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c 


R — RSCS local operator's console 
O —- Command originator 
V- Virtual machine user 
C — VM/370 CP operator 


Specific Command Responses (Continued) 


0 
0 


oO 


DMTCMX6541 
DMTCMX6551 


LINK *linkid’® S=s R=r Q=q P=p 
FILE "spoolid’ ('orgid’) "locid’ ‘userid’ 
CL a PR pp REC nnnnnnnn {HO| NOH} 


QUERY "linkid’® SUM: 


DMTCMX1491 


QUERY FILE 


DMTCMX660I1 


DMTCMX6611I1 


DMTCMX664E 


QUERY FILE 


DMT CMX6631 


DMT CMX664E 
DMTCMX666I 


QUERY FILE 


DMTCMX6621 


DMT CMX664E 


LINKID "linkid’ LINE ACTIVITY; TOT=mmmmmmmm; 
ERRS=nnnvannnnn; TMOUTS=pppppppp 


*spoolid’® STAT 


FILE "spoolid’ INACTIVE ON LINK ‘linkid’ 
FILE *spoolid’® ACTIVE ON LINK ‘linkid’ 
FILE *spoolid’ NOT FOUND 


*spoolid’ VM: 


FILE 'spoolid’ PR pp CL a FO ffffffff CO [x]nnn 
(HO|NOH) DI 'distcode', NA {"fn ft*|'dsname'} 
FILE *spoolid’ NOT FOUND 

FILE *spoolid’ FL ffff FLC nn MO mmmm CH cccc 
FCB bbbb 


"Sspoolid’ RSCS: 


FILE "*spoolid’ ORG ‘*locidl’ ‘useridl’ 
ORGID ‘orgid’® mm/dd/yy hh:mm:ss z.z.z. 
TO *locid2" "userid2' 

FILE *spoolid’ NOT FOUND 


QUERY SYSTEM ACTIVE: 


DMTCMX6701 


DMTCMX6721 


LINK *linkid’ {CONNECT|ACTIVE} -- LINE 
"vaddr’ {HO|NOH} {DR|NDR} {NOT|TRS|]TRL|TSL} 
NO LINK ACTIVE 


QUERY SYSTEM LINKS: 


DMTCMX6701 


DMTCMX6711 


LINK "linkid? {CONNECT|ACTIVE} -- LINE 
"'vaddr’ {HO|NOH} 
LINK "linkid’ INACTIVE 
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R — RSCS local operator's console 
O — Command originator 
V —- Virtual machine user 
C —- VM/370 CP operator 


Specific Command Responses (Continued) 


0 


oO 


oO 


yo. a ce) 


DMT CMX673I 


NO LINK DEFINED 


QUERY SYSTEM PORTS: 


DMT CMX625I1 
DMTCMX6261 
DMTCMX6271 


NO PORTS AVAILABLE 
PORT ‘vaddr* AVAILABLE 
PORT "*vaddr* IN USE BY LINK 


QUERY SYSTEM ROUTES: 


DMTCMX6341 
DMT CMX6361 


NO LOCATIONS ROUTED 
"locid' ROUTED THROUGH LINK 


QUERY SYSTEM QUEUE: 


DMT CMX6541 
DMTCMX674I1 


REORDER: 


DMT AXM1091 


ROUTE: 


DMT CMX6301 
DMTCMX6311 
DMT CMX632E 
DMT CMX633E 
DMT CMX638E 


SIGNON: 


DMT xxx902E 
DMT xxx903E 
DMTNPT90GE 
DMT xxx905T 
DMTNPT907E 
DMT xxx913E 


DMT xxx914E 


LINK ‘linkid’ S=s R=r Q=q P=p 
NO FILES QUEUED 


FILE QUEUE REORDERED 


*locid’ 
INDIRECT ROUTING FOR 


NOW ROUTED THORUGH LINK 
*locid’ DEACTI 


,linkid’ 


*linkid’ 


"linkid’ 


VATED 


EACHED 


Tlocid’ INVALID ROUTE SPECIFIED 
*locid’ NOT ROUTED -— ROUTE LIMIT R 
LOCATION ‘locid’ HAS A FILE QUEVE —— 


INDIREGT ROUTING NOT DEACTIVATED 


NON-SIGNON CARD READ ON LINK ‘Linki 
PASSWORD SUPPLIED ON LINK ‘linkid’ 
SIGNON PARAMETER=‘parm’ INVALID 
SIGNON of LINK "linkid’ COMPLETE 
SIGNON TYPE PARAMETER MISSING 


d* 
IS INVALID 


INVALID PASSWORD PARAMETER SPECIFIED —— 


LINK *linkid*® NOT ACTIVATED 
INCORRECT PASSWORD RECEIVED ON LINK 
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*linkid’ 


C 


R = RSCS local operator's console 
O —- Command originator 


V=- Virtual machine user 
C = VM/370 CP operator 


Specific Command Responses (Continued) 


DMTNCM915E 


DMTNCM916E 


DMTxxx91l8E 


DMT xxx9I1l9E 


START: 


DMTCMX7 001 


DMTCMX701E 


DMTCMX702E 


DMTCMX703E 


DMTCMX704E 


DMTCMX705E 


DMT CMX706E 


DMTCMX707E 


DMT CMX708E 


DMT CMX709E 


DMTCMX710E 


DMT xxx750E 


DMTCMX7511 


DMT xxx752I 
DMTSMLOOILE 


DMTxxx906E 


DMTPOWSOS3E 
DMTNITIILIE 


DMTNITS1ZE 


DMT xxx91ZE 


INCOMPATIBLE NJI BUFFER SIZES —-= LINK 
IS BEING DEACTIVATED 
INVALID NJI SIGNON CONNECTION RECORD RECEIVED —-- 


7linkid’ 


LINK *linkid’ IS BEING DEACTIVATED 

LINK "’linkid’ DOES NOT MATCH REMOTE LOCATION 
*locid’ 

SIGNON SEQUENCE ON LINK ‘linkid’ FAILED 
ACTIVATING LINK ‘"linkid’® "task’ ‘type’ 

"vaddr’ c 

NO SWITCHED LINE AVAILABLE -—--— LINK ‘'linkid’ 

NOT ACTIVATED 

LINE "vaddr’ IS IN USE BY LINK *"linkidl’ -— 

LINK *linkid2’ NOT ACTIVATED 

DEV 'cuu’ IS NOT A LINE PORT —-— LINK "linkid’' 
NOT ACTIVATED 

LINE ‘'vaddr’® CC=3 NOT OPERATIONAL -—-— 

LINK ’linkid’® NOT ACTIVATED 

DRIVER 'type’ NOT FOUND ON DISK ‘vaddr'" -— 

LINK *linkid’ NOT ACTIVATED 

FATAL ERROR LOADING FROM '’vaddr’ -—-— LINK *linkid’ 
NOT ACTIVATED 

DRIVER ‘'type’ FILE FORMAT INVALID -- LINK ‘linkid’ 
NOT ACTIVATED 

VIRTUAL STORAGE CAPACITY EXCEEDED —— LINK ‘'linkid’ 
NOT ACTIVATED 

TASK NAME ‘*task’* ALREADY IN USE -—-— LINK *linkid’ 
NOT ACTIVATED 

MAX (C'nn*) ACTIVE -— LINK "linkid’ NOT ACTIVATED 
LINK 'linkid*® ALREADY ACTIVE —— NO ACTION TAKEN 
LINK *linkid’® ALREADY ACTIVE -—-— NEW CLASS(ES) 
SET AS REQUESTED 

LINK 'linkid’ STILL ACTIVE -—— DRAIN STATUS RESET 
INVALID SML MODE SPECIFIED -—= LINK ‘*linkid’ 

NOT ACTIVATED 

INVALID BUFFER PARAMETER —— LINK *linkid? 


NOT ACTIVATED 

INVALID "PARM*’ PARAMETER ‘parmvalue’ 
INVALID NJI BUFFER SIZE SPECIFIED —— 
LINK *linkid’ NOT ACTIVATED 

INVALID NJI NODAL RESISTANCE SPECIFIED —— 
LINK *linkid’ NOT ACTIVATED 

INVALID PASSWORD PARAMETER SPECIFIED —— 
LINK "linkid’ NOT ACTIVATED 


SPECIFIED 
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R — RSCS local operator's console 
O — Command originator 
V=- Virtual machine user 
C — VM/370 CP operator 


Specific Command Responses (Continued) 


R DMTPOW946E INVALID POWER CPUID SPECIFIED —— LINK 
*linkid’ NOT ACTIVATED 


TRACE: 


DMTxxx801I LINK "*linkid’ LOG ACTIVATED 

DMTxxx802I LINK ‘linkid’ LOG DEACTIVATED 

DMTxxx803I LINK "*linkid*® SUM REPORTING DEACTIVATED 
DMTxxx81lQ0E LINK *linkid’ LOG ALREADY ACTIVE 
DMTxxx81llE LINK ‘linkid’ LOG NOT ACTIVE 

DMTxxx812E LINK ‘linkid’® SUM REPORTING ALREADY ACTIVE 
DMTxxx813E LINK "linkid® SUM REPORTING NOT ACTIVE 


mom HD DD BD 


TRANSFER: 


R DMTAXM524E FILE ‘*spoolid’® ACTIVE —-— NO ACTION TAKEN 
R DMTAXMS25E FILE "*spoolid’ IS FOR LINK ‘linkid’ -—— 
NO ACTION TAKEN 
R DMTAXMS526E FILE *spoolid’ NOT FOUND -— NO ACTION TAKEN 
R DMTAXM645I ‘'nn* FILECS) TRANSFERRED ON LINK ‘*linkid’ 


INITIALIZATION MESSAGES 


DMTINIG10I NUCLEUS WRITE COMPLETE 

DMTINI411R SYSTEM DISK ADDRESS = {ccu} 

DMTINIG12R REWRITE THE NUCLEUS ? {YES|NO} 

DMTINI413R NUCLEUS CYL/BLK ADDRESS = {nnn} 

DMTINIG81E INVALID DEVICE ADDRESS -—— REENTER 

DMTINIG82E INVALID CYL/BLK NUMBER -—— REENTER 

DMTINIG&83E INVALID REPLY -—— ANSWER "YES" OR "NO" 

DMTINI484E IPL DEVICE ERROR —— REENTER 

DMTINI485E NUCLEUS CYL/BLK SPECIFICATION UNACCEPTABLE, ERROR '*x' 
DMTINI498S IPL DEVICE WRITE I/O ERROR 

DMTINI499T IPL DEVICE READ I/O ERROR 

DMTIRX449I MAX TAGS REQUEST OF 1 PER VIRTUAL STORAGE K ASSUMED 
DMTIRX450E INVALID DIRECTORY ENTRY 

DMTIRX451E DIRECTORY ENTRY OUT OF ORDER 

DMTIRX452E LOCAL PREVIOUSLY SPECIFIED 


os i ee: es ee ee ee: ee es es es es = Bs Be] 
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C 


R — RSCS local operator’s console 
O — Command originator 

V=- Virtual machine user 
C — VM/370 CP operator 


Initialization Messages (Continued) 


za AAD ADA ADA ADA AA ADA A DAA ADA AAD A 


DMTIRX453E 
DMTIRX45G4E 
DMTIRX455E 
DMTIRX456E 
DMTIRX457E 
DMTIRX458E 
DMTIRX461E 
DMTIRX462E 
DMTIRX463E 
DMTIRX464E 
DMTIRX465E 
DMTIRX466E 
DMTIRX467E 
DMTIRX468E 
DMTIRX469E 
DMTIRX490T 
DMTIRX491T 
DMTIRX492T 
DMTIRX493T 
DMTIRX494T 
DMTIRX495T 


PARM PREVIOUSLY SPECIFIED FOR LINK 
TAGS PREVIOUSLY SPECIFIED 
DUPLICATE LOCATION ID 

DUPLICATE LINK ID 

DUPLICATE PORT ADDRESS 

UNDEFINED LINK ID 

LOCATION ID MISSING OR INVALID 
LINK ID MISSING OR INVALID 

INVALID DRIVER SPECIFICATION 

PORT ADDRESS MISSING OR INVALID 
INVALID ZONE SPECIFICATION 

INVALID TASK SPECIFICATION 

INVALID CLASS SPECIFICATION 
INVALID KEEP SPECIFICATION 

TAGS COUNT MISSING OR INVALID 
UNSUPPORTED SYSTEM RESIDENCE DEVICE 
FATAL ERROR READING RSCS DIRECT 
FATAL ERROR LOADING DMTAXS 

FATAL ERROR LOADING DMTLAX 

LOCAL LOCATION DEFINITION MISSING 
VIRTUAL STORAGE SIZE INSUFFICIENT FOR INITIALIZATION 


RSCS WAIT STATE CODES 


When RSCS enters a wait state, the RSCS operator is notified via the CP 


message: 
DMKDSP450W CP ENTERED; DISABLED WAIT PSW 
issued to the RSCS operator’s console. 


display the virtual machine's PSW. 
Indicate the error condition. 


Using CP commands, the operator can 
The three rightmost hexadecimal characters 


001 Explanation: If no RSCS message was issued, a program check interrupt 
occurred during the execution of the program check handler. The probable 
cause 15 a programming error. If the RSCS message: 


DMTREXO91T INITIALIZATION FAILURE -= RSCS NETWORKING SHUTDOWN 
was issued, RSCS operation was terminated because of an error in loading 
DMTAXS or DMTLAX. A dump of virtual storage is automatically taken. 


Verify that CMS files DMTAXS TEXT and DMTLAX TEXT are correctly written 
and resident on the RSCS system residence device. If the RSCS message: 
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007 


011 


012 


DTIMREXO9S0T PROGRAM CHECK IN SUPERVISOR —-— RSCS NETWORKING SHUTDOWN 


Was issued, the program check handler terminated RSCS due to a program 
check interrupt in other than a dispatched line driver. The probable 
Cause 1S a programming error. The wait state code is loaded by DMTREX at 
RSCS termination or automatically during program check handling. 


Operator Action: If neither of the above two messages was issued, use 
the CP DUMP command to dump the contents of virtual storage. IPL to re- 
start. If the problem persists, notify local RSCS system support 
personnel. 


Explanation: A program check interrupt occurred during initial 
processing, before the program check handler could be activated. This 
may be caused by a programming error or by an attempt to load RSCS into 
an incompatible virtual machine. The latter case can occur if the 
virtual machine has an incomplete instruction set, or does not have the 
required VM/370 Diagnose interface support. The wait state code is 
loaded automatically during the initial loading and execution of the RSCS 
supervisor, DMTINI, DMTREX, DMTAXS, and DMTLAX. 


Operator Action: Verify that the RSCS virtual machine configuration was 
correctly specified and that the "retrieve subsequent file description"™ 
function of DIAGNOSE code X'14" is supported. Dump the contents of 
virtual storage via the CP DUMP command. If the problem persists, notify 
local RSCS system support personnel. 


Explanation: An unrecoverable error occurred while reading the RSCS 
nucleus from DASD storage. This may be caused by a DASD hardware 
malfunction. It may result from (1) an incorrect virtual DASD device 
definition, (2) an attempt to use a system residence device unsupported 
by RSCS, (3) incorrect RSCS system generation procedures, or (4) the 
subsequent overwriting of the RSCS nucleus on the system residence 
device. The wait state code 1s loaded by DMTINI after an attempt, 
successful or not, to issue the message: 


DMTINIGO2I IPL DEVICE READ I/0 ERROR 


Operator Action: Verify that the RSCS system residence device was 
properly defined as a virtual DASD device and that the real DASD device 
715 mounted and operable. If the problem persists, dump virtual storage 
via the CP DUMP command and notify local RSCS system Support personnel. 
The RSCS system residence device may have to be restarted or RSCS may 
have to be regenerated. 


Explanation: The RSCS nucleus Was successfully written to the RSCS 
system disk. This wait state code occurs at the end of RSCS system 
generation following the message: 


DMTINI410I NUCLEUS WRITE COMPLETE 


Operator Action: Test the newly loaded RSCS system by IPLing from the 
disk that contains the new nucleus. 
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Appendix C: RSCS Networking User Exits 


The CP spool interface routine, the AXS task, consists of two CSECTs, DMTAXM 
and DMTAXA. DMTAXA contains entry points to several routines, specifically 
designed for user exits, that are all called from DMTAXM. DMTAXA also 
contains code that creates VM/370 account records. 


The routines contained in DMTAXA are: 


DMTAXAAC entered when a file iS accepted and enqueued for 
transmission. 


DMTAXASE entered when all copies of a file have been 
sucessfully sent. 


DMTAXAPU entered when a file is deleted as a result of the 
PURGE command. 


DMTAXARE entered when a file has been received and written to 
the VM/370 spool system for real unit record 
processing, for delivery to a local virtual machine 
userid, or for forwarding on the network (as 
determined by the file's destination address). 


DMTAXATA entered when a file iS ready to be enqueued with the 
priority value (TAGPRIOR) in the TAG. 


When entering the above routines, the register contents are as follows: 
address of TAG slot for file 


return address 
entry point address 


Register 2 
Register 14 
Register 15 


The TAG dsect contains the following information (the fields that can be 
altered are marked x"): 


TAGINLOC * eriginating location 


TAGLINK next location for transmission 
TAGINTOD * time of file origin 

TAGINVM * eriginating virtual machine 
TAGRECNM number of records in file 
TAGRECLN maximum file data record length 
TAGINDEV device type of originating device 
TAGCLASS x file output class 

TAGID VM/370 current spool file id 
TAGCOPY x number of copies requested 
TAGFLAG VM/370 SFBLOK control flags 
TAGFLAG2 VM/370 SFBLOK control flags 
TAGORGID x VM/370 spool id at origin locid 
TAGNAME x file name 
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TAGTYPE x file type 

TAGDIST * file distribution code 

TAGTOLOC * destination location id 

TAGTOVM * destination virtual machine id 
TAGPRIOR x transmission priority 

TAGDEV active file’s virtual device address 
TAGCNTRL network control record format 
TAGRECLT number of records left in file 
TAGSPARE spare fullword 

TAGFORMN x form name 

TAGFLSHN * 3800 flash name 

TAGMODN x 3800 copy modification module name 
TAGCHARN * 3800 character arrangement table name 
TAGFCBN * 3800 fcb name 

TAGFLC * 3800 flash count 

TAGFLAG3 * 3800 flag byte 

TAGRESV reserved 


For a detailed layout of the TAG DSECT, refer to RSCS Networking Logic 
(LY24-5203). 


The following example shows the code at a typical user exit in DMTAXA: 


DMTAXATA EQU x 


USING DMTAXATA,R15 GET TEMP ADDRESSABILITY 
STM RO,R15,AXASAVE SAVE REGISTERS 

DROP R15 

USING DMTAXATA,R12 GET RIGHT ADDRESSABILITY 
LR R12,R15 AND UPDATE R12 


re (insert user code here) 


LM RO,R15,AXASAVE RESTORE REGISTERS 
BR R14 RETURN TO CALLER 


Below is a fuller description of the current function Cif any) of each 
of the entry points and of the sort of additional use to which they may 
be put. 


DMTAXAAC? This routine is entered whenever a file has been received 


from the CP spool system for transmission (which includes all files 
being store-and-forwarded). On return to DMTAXM, the file is accepted 
only if a zero value is returned in register 15; otherwise, it is 
rejected. The current code clears register 15 and returns immediately. 
If the file is selected to be rejected (a non-zero value in register 
15), message DMTAXM1I12E FILE "*spoolid’ (C’orgid’) REJECTED BY RSCS 
ACCOUNTING EXIT is sent to the originator. If the originator is a local 
VM/370 user, the file is transferred to that user’s virtual reader. 
Files that do not originate on the local VM/370 system are purged. 
Additional code could be added here to determine whether a file should 
be transmitted based upon any suitable criteria (e.g. maximum record 
count, unauthorized or authorized users, etc.). 


DMTAXASE: This routine is entered when all copies of a file have been 
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sucessfully transmitted on a link. Only if the file originated on the 

local VM/370 system is an account record produced (via Diagnose X'4C"). 
The standard account record contains the following information: 

e The local RSCS userid 

e The originating userid 

e The date and time of accounting record creation 

e The origin spool file id 

¢ The local spool file id 

e The originating location id 

e The destination location id 

e The spool file class 

e The originating device type 

e The record count for the file 

¢ The local system id 

e An account code (X'Q1' for SEND) 

The routine can be modified to record different information if required 
by adding the necessary code and changing the account record layout 


which is defined at label ACNTBUFF. 


For a detailed layout of the accounting record, refer to RSCS Networking 
Logic (LY24-5203). 


DMTAXAPU: This routine is entered after a file has been deleted by the 
PURGE command. Currently it performs an immediate return, but code can 
be added to create an account record containing information efrut the 
deleted file or perform any other suitable function. 


DMTAXARE: This routine is entered whenever a file has been received 
over the network and written to the VM/370 spool system. It currently 
creates an account record of identical format to that created on file 
receipt (except that the account code is X'02"). The routine can be 
modified to record different information or perform any suitable 
function at file arrival time. 


DMTAXATA: This routine is entered when a file TAG is ready to be 


enqueued with the priority value contained in TAGPRIOR. Currently no 
function is performed in this routine, but code could be added to ensure 
that the priority option is not misused (e.g. priority 1 for a 20,000 
record file), or an automatic priority scheme can be implemented by 
having this exit set a priority value based on some information in the 
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| tag, such as the record count, the originating userid, location ID, etc. 
Refer to subsection "UPDATING RSCS"™ in section "Installing RSCS" in this 


manual for information on rebuilding the AXS task after making any 
modifications to DMTAXA. 
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Appendix D: Nonprogrammable Remote Terminals 


This appendix contains operational information for each of the following 
remote nonprogrammable terminals supported by the NPT line driver: 


e IBM 2770 Data Communication System 

e IBM 2780 Data Transmission Terminal, Models 1 and 2 

* IBM 3770 Data Communication System, nonprogrammable models 
e IBM 3780 Data Communications Terminal 

The following topics are discussed for each terminal: 

e Supported configuration 

e Operational notes 

e Entering commands 

e Error recovery procedures 

Note: The operating and error recovery procedures for the 
RSCS=supported nonprogrammable remote terminals were obtained from the 


publications listed in the Preface. If conflicts eccur, refer to the 
latest editions of those publications. 


IBM 2770 AS A REMOTE TERMINAL 


———-H TT aoe ED EEE 0 Genco 


SUPPORTED CONFIGURATION 


The IBM 2770 Data Communication System with the 2772 Multipurpose 
Control Unit (from now on called 2770) can be used as an NPT remote 
terminal. It can be connected to RSCS via a switched or leased 
point-to-point communication line. 


The following devices are required for operating a 2770 as an NPT remote 
terminal: 
e One IBM 2213 Printer, Model 2, or one IBM 2203 Printer, or one IBM 


1053 Printer 


e One IBM 2502 Card Reader, Model Al or A2 


Appendix D: Nonprogrammable Remote Terminals 5D—-1 


e EBCDIC Transmission Code 
Other supported equipment and features are: 


e One IBM 5425 Card Punch, Model 3 or 4, With or without 3950 
attachment. 


e EBCDIC Transparency (Feature 3650) 

e Buffer Expansion (Feature 1490) 

e Additional Buffer Expansion (Feature 1491) 
e Space Compression/Expansion (Feature 6555) 


e Synchronous Clock (Feature 7705) 


2770 OPERATIONAL NOTES 


Establishing the connection with RSCS is the same for all nonprogram— 
mable terminals and is covered in "Part 3: RSCS Operation” under 
"Starting NPT™ and "Signing on to NPT". 


For all 2770 terminal sessions with NPT, set the 2770 console switches 
as follows: 


Switch Setting 
JOB SELECT VARIABLE SELECT SELECT 


INPUT KEYBOARD, 2 


(card reader) both up 
OUTPUT PRINTER, 2 
(card punch) both up 
DIRECT DATA OUTPUT PRINTER up 
TERM MODE LINE 
SELECTION REQD down 
ANSWER MANUAL 
MONITOR PRINT as desired by installation, normally down 
Any of above that refer to 
device not on your 2770 down 


All other VARIABLE SELECT 
Switches down 


During. installation, your 2770 may have been provided with the 
equivalent of all the above switch settings at one of the five JOB 
positions on the JOB SELECT switch. If so, simply set to that position 
and ignore all VARIABLE SELECT switches. When power is on, console 
lights show the settings that are in effect. 


Set the TRANSPCY switch down except when transmitting EBCDIC card decks 
that use all 256 possible punch combinations. 


5D-2 IBM VM/370: RSCS Networking — Ref and Operations 


ENTERING COMMANDS 


The remote terminal operator submits commands to RSCS through the remote 
card reader in the same manner as he enters card files. The commands 
are punched, one per card, starting in column 1. One or more commands 
may be submitted at any one time. Commands are only accepted before the 
ID card of an input card deck or after an input card deck has been 
completely processed (end-of-file generated). 


TERMINATING A SESSION 


To terminate a session, the remote terminal operator issues the DRAIN 
command. The link is deactivated after the file currently being 
processed is completed. 


ERROR RECOVERY PROCEDURES 


Most problems you encounter result in lights appearing on the 2770 
console or the I/0 devices themselves. Some lights are not error 
lights; these are DATA SET READY, CARRIER OFF, DATA IN BUFFER, LINE 
MODE, PROCEED, BID, SELN REQD, TRANSPCY, MANUAL ANSWER, and any of the 
I/O device lights that are not blinking. Any blinking I/O device light 
indicates that the device is not ready. Other lights provide clues to 
problems and are discussed in the following sections. 


Error Recovery for a Line Drop 


If for any reason a line drop occurs, all activity at the remote 
terminal halts. If the terminal was receiving, the printer or punch 
stops. If the terminal was transmitting, the reader stops and RSCS 
closes the partially transmitted file. 


To restart, you must redial the line and reenter your SIGNON card. When 
the SIGNON card is accepted by RSCS, normal line activity resumes. If 
receiving, activity restarts from the point of interruption. If trans-— 
mitting, you can either restart from the file that was interrupted or 
you can send the rest of the data as a separate file. 


If some other user dials in on the disconnected line before you do and 
submits his own SIGNON card, RSCS recognizes the new linkid as being 
different from the one in effect When the line dropped. The new user is 
terminated and the link is deactivated. If your terminal was receiving, 
the printer or punch file is placed at the end of the queue for your 
link and is put into HOLD status. 
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To restart under these circumstances, you must first have the RSCS 
operator reactivate your link via the START command. You can then 
redial the line and resubmit your SIGNON card. When the SIGNON card is 
accepted, line activity resumes. Transmission can be either continued 
or restarted. Printer or punch output resumes with the file following 
the one that was active when the line dropped. To process the inter- 
rupted file, you must change its status from HOLD to NOHOLD via the 
CHANGE command. 


Error Recovery When Transmitting 


When transmitting, any card reader trouble is indicated by a blinking 
INPUT 2 or 3 light, whichever your card reader is attached to. The 
following lights on the card reader may further indicate the type of 
trouble: 


FEED CHECK 
The bottom card in the hopper failed to feed. Remove the cards 
from the hopper. Press the Non—Process Runout (NPRO) button. 


Repair the bottom hopper card, if necessary, and make sure the feed 
throat is clear. Reload the cards and press reader START and 
console START. 


ATTENTION 
Full stacker or empty hopper with EOF off. Correct the problem, 
then press reader START and console START. 


READ CHECK 

VALIDITY CHECK 
Last card in the stacker (if no jam) and the following card (run 
out by NPRO after hopper cards are removed) must be re-read. After 
appropriate correction, place these two cards at the front of the 
card stack in the hopper, and press reader START and console START. 


TERMINAL ADDRESS 
The NPT program is trying to send output while you are trying to 
start an input function. Continue the input procedure until you 
have turned on the BID light. Then press CHECK RESET and wait for 
input to begin. Press CHECK RESET again if TERMINAL ADDRESS comes 
on again. 


BID RETRY 
The NPT program has failed to give permission to transmit. Press 
CHECK RESET to cause the 2770 to try again. If this fails, ask the 
local RSCS operator to check the task. 


INPUT CHECK 

BUFFER CHECK 

TRNSPCY CHECK 
With any one of these serious errors, you must always restart the 
job. Make sure you have turned on the TRANSPCY switch if the input 
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card deck contains object decks or other cards requiring 
transparent transmission. 


RECORD CHECK 

LINE CHECK 
These lights may come on while NPT is trying retransmissions for 
line errors; they will go out if recovery is successful. If they 
stay on and the transmission does not proceed, you must do a CHECK 
RESET and restart the output device for output to continue. 


Note: It is possible in this case to lose a record, or to have a 
record duplicated. 


Error Recovery When Receiving 


Output device trouble is indicated by blinking OUTPUT PRINTER or OUTPUT 
2 lights on the devices as follows: 


CARRIAGE CHECK 
The printer carriage, forms, or carriage tape are not ready or 


jammed. Correct the condition and press console CHECK RESET and 
START. 


PRINT CHECK 


The printer had a parity error. Press console CHECK RESET and 
START. Failure to recover indicates hardware trouble. 


CHECK light or any card punch not ready condition 
Hopper empty, stacker full, or jams are the possible causes. Set 
the keyboard switch to KEYPCH. Remove any cards from the stacker 
or the eject station just below the stacker and discard all cards 
after the last one with a column 80 punch. Clear the entire card 
feed path. With blank cards in the hopper, press the FEED key 
twice and the RELEASE key once and then set the switch to AUTO PCH. 
Press console CHECK RESET and START. The first card through the 
feed after recovery is blank and should be discarded. 


When receiving, the following console lights may require your attention: 


TERMINAL ADDRESS 


The NPT program is trying to send output but your 2770 is not 
ready. Make sure your switch setup is correct, ready all output 
devices, and press console CHECK RESET. 


OVERRUN 
This usually indicates that features on your 2770 were not speci- 
fied correctly when you signed on to the RSCS virtual machine. Ask 
the RSCS operator either to restart the task in order to send the 
correct SIGNON card or to change the recorded configuration. 


BUFFER CHECK 
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This hardware error always requires you to reset and restart the 
operation. Failure to recover indicates hardware trouble. 


LINE CHECK 
The NPT program is trying retransmissions. If they are successful, 
the light goes out. If the light stays on and printing or punching 
does not continue soon, you must restart the line. 


For other combinations of error lights consult the publication System 
Components: IBM 2770 Data Communications System, GA27-3013. 


IBM 2780 AS A REMOTE TERMINAL 


SUPPORTED CONFIGURATION 


The IBM 2780 Data Transmission Terminal, Models 1 and 2, used as NPT 
remote terminals, can be connected to RSCS via a switched or leased 
point—to-point line. EBCDIC Transmission (Feature 9762) is required. 


The following supported features are optional: 


EBCDIC Transparency (Feature 8030) 


120/144-Character Print Line (Feature 5820 or 5821) 


Multiple Record Transmission (Feature 5010) 


Synchronous clock (Feature 7705) 


2780 OPERATIONAL NOTES 


Establishing the connection with RSCS is the same for all nonprogram— 
mable terminals and is covered in “Part 3: RSCS Operation™ under 
"Starting NPT™ and "Signing on to NPT”. 


After establishing the connection with RSCS, perform the following 
steps: 


1. Make sure that the mode-selection knob is at one of the positions 
TSM-TRSP, TSM, or REC. Do not put the knob in the PRINT or PUNCH 
position. (To receive a punch file, put the knob in the REC 


position.) 


2. Press START on the printer. 
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ENTERING COMMANDS 


The remote terminal operator submits commands to RSCS through the remote 
card reader in the same manner as he enters card files. The commands 
are punched, one per card, starting in column 1. One or more commands 
may be submitted at any one time. Commands are only accepted before the 
ID card of an input card deck or after an input card deck has been 
completely processed (Cend-of—file generated). 


TERMINATING A SESSION 


To terminate a session, the remote terminal operator issues the DRAIN 
command. The link is deactivated after the file currently being 
processed is completed. 


ERROR RECOVERY PROCEDURES 


Most problems you encounter result in lights appearing on the reader-— 
punch or printer control panels. Some lights are not error lights; 
these are DATA SET READY, the two READY lights, END OF FILE, I/0 BFR 
FULL, CTR1, CTR2, CTR& and usually LINE. 


POWER-—ON reset 
The POWER-ON reset operation is referred to frequently throughout 
this manual. Contrary to its name, a POWER-ON reset does not 
involve the 2780 POWER ON/OFF switch (Con the right side of the 
2780); this switch needs to be turned on only once during 2780 
operations. You can perform a POWER-ON reset by turning the mode 
selection switch knob from its current position to any other 
position. This resets the 2780. If the knob is already Where you 
Want it, then turn it to some other position and back to the 
desired one. 


CAUTION: Do not do a POWER-ON reset when the printer is printing, 
or while cards are being read or punched. 


Error Recovery for a Line Drop 


If for any reason a line drop occurs, all activity at the remote 
terminal halts. If the terminal was receiving, the printer or punch 
Stops. If the terminal was transmitting, the reader stops and RSCS 
closes the partially transmitted file. 


To restart, you must redial the line and reenter your SIGNON card. When 
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the SIGNON card iS accepted by RSCS, normal line activity resumes. If 
receiving, activity restarts from the point of interruption. If 
transmitting, you can either restart from the file that was interrupted 
or you can send the rest of the data as a separate file. 


If some other user dials in on the disconnected line before you do and 
submits his own SIGNON card, RSCS recognizes the new linkid as being 
different from the one in effect when the line dropped. The new user is 
terminated and the link is deactivated. If your terminal was receiving, 
the printer or punch file is placed at the end of the queue for your 
link and is put into HOLD status. 


To restart under these circumstances, you must first have the RSCS 
operator reactivate your link via the START command. You can then 
redial the line and resubmit your SIGNON card. When the SIGNON card is 
accepted, line activity resumes. Transmission can be either continued 
or restarted. Printer or punch output resumes with the file following 
the one that was active When the line dropped. To process the inter- 
rupted file, you must change its status from HOLD to NOHOLD via the 
CHANGE command. 


Error Recovery When Transmitting 


TERM ADDR 
This light comes on when you are reading cards. If the cards stop 
reading and the READY and TERM ADDR lights are on, perform the 
following steps: 


1. Remove the cards from the hopper and press NPRO to run out the 
two cards in the feed. 


2. Put these two cards in front of the deck previously removed in 
Step 1, and place the cards back in the hopper. 


3. Do a POWER—-ON reset. 


4. Wait for the TERM ADDR light to come on again. ThisS may take 
as long as 10 seconds. 


5. Do another POWER-ON reset, press the END OF FILE and START, so 
that the END OF FILE and READY lights come on. 


6. Cards should start reading within 15 seconds. If they do not, 
and the TERM ADDR light comes on again, repeat the above 
steps. 

If the above steps continue to fail, you may have interrupted 
printing or punching to read in cards before the printing or 


punching had completed. Try to ready the printer and punch. 


DATA CHECK 
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DATA CHECK and EQUIP CHECK 


| DATA CHECK, EQUIP CHECK, and PARITY CHECK 
| The reader could not read a card correctly. Perform the following 
steps: 


1. Remove cards from the hopper (not the stacker). 


rar Press NPRO. Two cards will run out into the stacker. The 
first of these cards is the bad one. 


3. Correct the bad card. 


4. Put both cards back in the hopper, followed by the cards you 
removed from the hopper. 


5. Press END OF FILE and START so that the END OF FILE and READY 
lights come on. 


OVER RUN 

PARITY CHECK 

PARITY CHECK and EQUIP CHECK 

RECORD and LINE 
To correct errors when these lights are on, you must first find out 
how many :cards have been read but not yet transmitted. Add up the 
CTR lights to do this. For example, if CTR1 and CTR2 are on, three 
cards have been read, but not yet transmitted. Without removing 
all cards from the stacker: 


1. Remove the cards from the hopper. 
2. Press NPRO to run out the two cards in the feed mechanism. 


3. Remove the last N+2 cards from the stacker, where N is the 
number of cards read but not yet transmitted. 


4. Put these cards back into the hopper, followed by the cards 
you removed from the hopper in Step 1. Do a POWER-ON reset. 


5S. Press END OF FILE and START so that the END OF FILE and READY 
lights come on. 


EQUIP CHECK 
A mechanical error has occurred. Use the procedure for DATA CHECK, 
but you should not need to correct a card. 


LINE 
Wait a few moments to see whether or not the reader starts reading 
cards by itself. If it does not: 
1. Press STOP. 


2. Press END OF FILE and START so that the END OF FILE and READY 


( lights come on. 


Appendix D: Nonprogrammable Remote Terminals 5D-9 


HOPR 
No card was fed. Check the bottom card in the hopper for damaged 
edges. Repair or remake the card and replace it and the rest of 
the cards back in the hopper. Press END OF FILE and START so that 
the END OF FILE and READY lights come on. 


Error Recovery When Receiving 


Some of the errors you may encounter are self-explanatory, such as END 
OF FORM (another box of paper is needed) or FORM CHECK (the paper is 
jammed). 


One error deserves particular attention. It is indicated by OVER RUN 
and INCP. If you get this error, you may have specified the wrong 
remote configuration on the SIGNON card and NPT is trying to use 
features your 2780 Data Transmission Terminal does not have. Ask the 
RSCS operator either to restart the task, in order to send the correct 


SIGNON card, or to change the recorded configuration in the RSCS link 
table via the DEFINE command. 


You may also see the following error indicators: 


TERM ADDR 
The device (printer or punch) is not ready. 


1. Press STOP and CHECK RESET on the reader—punch. 
Z2. Make the output device ready. 
EQUIP CHECK 
The punch has mechanically malfunctioned. Press NPRO to run out 
the cards in the feed mechanism and discard them. Make the punch 


ready again. 


SYNCH CHECK 
The printer has printed a line containing errors. 


1. Press STOP. 
2. Press RESET (on printer). 
3. Press the START button on the printer; the line is reprinted. 
PARITY CHECK 
If the printer was printing, do a POWER-ON reset and press START on 
the printer. (You may get some duplicate print lines.) 


If the punch was punching: 


1. Remove cards from the hopper (not the stacker) 
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2. Press NPRO to run out the two cards in the feed mechanism 
3. Throw away the last N+K cards that were stacked, where: 
N is the number represented by the CTR lights. For example, 
if CTR1 and CTR2 are lit, N is 3; if all CTR lights are 
off, N is O. 


K = 2 if all CTR lights are off or if the I/0 BFR FULL light 
is off. 


l1 if any of the CTR lights and the I/0 BFR FULL light are 
on. 


4. Reload blank cards in the hopper and make the punch ready 


For other -combinations of error lights, consult the publication IBM 2780 
Data Transmission Terminal ~= Component Description, GA27-3005. 


IBM 3770 AS A REMOTE TERMINAL 


SUPPORTED CONFIGURATION 


The IBM 3770 Data Communication System can be used as an NPT remote 
station only when operating in 2770 or 3780 BSC mode. It can be 
connected to RSCS via a switched or leased point-to-point communication 
line. The IBM 3770 is only supported on a communication line 
terminating in an Integrated Communications Adapter (ICA) on the 
System/370 Model 135, an IBM 2701, or an IBM 3704/3705 Communications 
Controller. The 3770 keyboard is not supported. 


The following devices are required for operating the 3770 as an NPT 
remote station: 


e One of the following communication terminals: 


IBM 3771 Models 1, 2, and 3 (in 2770 mode) 

IBM 3773 Models 1, 2, and 3 (in 2770 mode) 

IBM 3774 Models 1 and 2 (in 2770 mode) 

IBM 3775 Model 1 (Cin 2770 mode) 

IBM 3776 Models 1 and 2 (in 2770 or 3780 mode) 
IBM 3777 Model 1 (Cin 2770 or 3780 mode) 


e One IBM 2502 Card Reader, Model Al, A2, or AZ IBM 3501 Card Reader or 
IBM 3521 Card Punch with the read feature installed 


The valid terminal/reader combinations are shown on the following table. 


Appendix D: Nonprogrammable Remote Terminals 5D-11 


Note The applicable attachment features must also be ordered. 


Communication Reader 
Terminal Supported 
IBM 3771 3501, 3521 
IBM 3773 NONE 

IBM 3774 NONE 

IBM 3775 NONE 

IBM 3776 3501, 3521 
IBM 3777 2502 


The 3773, 3774, and 3775 communication terminals are supported only for 
console printer output and for input (in card image format) from the 
diskette. For further information on these terminals, refer to the 
following publications: 


IBM 3773, 3774, and 3775 Programmable Communication Terminals: 


Programmer's Guide, GC30-3028 


Operator's Guide, GA2Z7-3114 


The following features/functions are included with 2770/3780 BSC 
compatibility: 


e EBCDIC transmission code 

e EBCDIC transparency 

e 256/256 byte alternating buffers (2770 mode) 
e 512/512 byte alternating buffers (3780 mode) 
e Extended retry 

e External clock Cup to 4800 BPS) 

e WACK response 

e Printer form controls 

e Device selection 

e Expanded print line (132 positions) 


e Transmit/receive monitor print (The 2770 prints only after positive 
acknowledgement from the line. The 3770 always prints.) 


Other supported equipment and functions are: 
e One IBM 3521 Card Punch (not supported on 3773 or 3777) 


e One IBM 3784 Line Printer (standalone, with 3774 only) 
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e Space compression/expansion 
e Diskette storage 


If installed, the diskette can give expanded input/output capability 
with 2770/3780 BSC operations. 


When the 3770 is in 2770/3780 BSC mode, it has two operator-selected 
modes for remote component selection: 


l. Data to Selected Device with Default to Printer: In this mode of 
operation, the data from the line is directed to the output device 
specified by the component selection (DC) character received. 


Component selection characters used are as follows: 


DC1l — Selects Console Printer 
DC2 —= Selects Card Punch 

DC3 — Selects Disk 

DC&4 = Selects Line Printer 


If no component selection (DC) character is received, an automatic 
default occurs to output the data to the printer. 


2. Data to Maghetic Disk with Transparent Data to Punch: In this mode 
of operation, the data from the line is directed to the magnetic 
disk unless it is transparent data. If transparent data is 
received, it is directed to the punch. If component selection (DC) 
characters are received, they are stripped off and ignored. 


3770 OPERATIONAL NOTES 


Establishing the connection with RSCS is the same for all 
nonprogrammable terminals and is discussed in “Part 3: RSCS Operation” 
under "Starting NPT” and "Signing on to NPT”. 


Operation of the 3770 system is discussed in the following publications: 


Operating Procedures Guide: 


IBM 3771 and 3773 Communications Terminals, GA27—3100 


IBM 3774 and 3775 Communications Terminals, GA27—-3094 


IBM 3776 Communication Terminal, GA27-3107 


IBM 3777 Communication Terminal, GA27—-3124. 


Appendix D: Nonprogrammable Remote Terminals 5D-13 


ENTERING COMMANDS 


The remote terminal operator submits commands to RSCS through the remote 
card reader in the same manner as he enters card files. The commands 
are punched, one per card, starting in column 1. One or more commands 
may be submitted at any one time. Commands are only accepted before the 
ID card of an input card deck or after an input card deck has been 
completely processed (end-of-—file generated). 


TERMINATING A SESSION 


To terminate a session, the remote terminal operator issues the DRAIN 
command. The link is deactivated after the file currently being 
processed is completed. 


ERROR RECOVERY PROCEDURES 


The OPRN CHECK (Operational Check) indicator turns on when an operating 
procedure error occurs, or an input or output device needs some operator 
attention (such as a printer out—of—forms condition). An error code 
displays in the numeric position readout (NPR) indicators. 


The SYSTEM CHECK indicator turns on when a controller, or an input or 
output device error occurs. An error code displays in the numeric 
position readout (NPR) indicators. 

The operator panel speaker sounds when an operational check or a system 
check occurs; if installed, the audible alarm sounds for jobs other than 
keyboard jobs when the EXTEND/ALARM switch is on. 

When the 3770 stops due to an error or an attention condition: 


© Either the SYSTEM CHECK or the OPRN CHECK indicator is on. 


¢ If an input or output device error occurred, the operator panel 
indicator for the device in error turns on. 


¢ The number displayed in the readout (NPR) indicates the error type. 
If the audible alarm sounds, press the RESET key to turn it off. For 
the error recovery procedure that applies to the error code number 


displayed, see the section "Numeric Position Readout (NPR) Error Codes” 
in the Operating Procedures Guides for 3770 terminals. 
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Error Recovery for a Line Drop 


If for any reason a line drop occurs, all activity at the remote 
terminal halts. If the terminal was receiving, the printer or punch 
stops. If the terminal was transmitting, the reader stops and RSCS 
closes the partially transmitted file. 


To restart, you must redial the line and reenter your SIGNON card. When 
the SIGNON card is accepted by RSCS, normal line activity resumes. If 
receiving, activity restarts from the point of interruption. If 
transmitting, you can either restart from the file that was interrupted 
or you can send the rest of the data as a separate file. 


If some other user dials in on the disconnected line before you do and 
submits his own SIGNON card, RSCS recognizes the new linkid as being 
different from the one in effect When the line dropped. The new user is 
terminated and the link is deactivated. If your terminal was receiving, 
the printer or punch file is placed at the end of the queue for your 
link and is put into HOLD status. 


To restart under these circumstances, you must first have the RSCS 
operator reactivate your link via the START command. You can then 
redial the line and resubmit your SIGNON card. When the SIGNON card is 
accepted, line activity resumes. Transmission can be either continued 
or restarted. Printer or punch output resumes with the file following 
the one that was active when the line dropped. To process the inter-—- 
rupted file, you must change its status from HOLD to NOHOLD via the 
CHANGE command. 


IBM 3780 AS A REMOTE TERMINAL 


A FE Fo ETE 


SUPPORTED CONFIGURATION 


The IBM 3780 Data Communications Terminal, used as an NPT remote 
station, can be connected to RSCS via a switched or leased 
point-to-point communications line. EBCDIC transmission code is 
required. 

The following devices and features are optional: 

e¢ One IBM 3781 Card Punch 

e Component Selection (Feature 1601, required for the 3781) 

e EBCDIC Transparency (Feature 3601) 


e Additional Print Positions (Feature 5701) 


e Synchronous Clock (Feature 7705). 
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3780 OPERATIONAL NOTES 


Establishing the connection with RSCS is the same for all 
nonprogrammable terminals and is covered in "Part 3: RSCS Operation” 
under “Starting NPT” and "Signing on to NPT". 


For 3780 operations with NPT, set the following 3780 console switches: 


Switch Setting 

TERM MODE LINE/HOME LINE 

TRNSPCY ON or OFF as desired 
SPACE COMPRESS/EXPAND ON or OFF as desired 
OFF LINE TEST OFF 

AUTO RESTART ON 

INQUIRY MODE OFF 

ANSWER AUTO/MAN OFF 


TELE (WORLD TRADE ONLY) OFF 
SPEED (WORLD TRADE ONLY) At desired transmission speed 


ENTERING COMMANDS 


The remote terminal operator submits commands to RSCS through the remote 
card reader in the same manner as he enters card files. The commands : 
are punched, one per card, starting in column 1. One or more commands J 
may be submitted at any one time. Commands are only accepted before the 
ID card of an input card deck or after an input card deck has been 
completely processed (end-of—-file generated). 


Interrupting Output Processing 


If it becomes necessary to enter a command or input card file while the 
terminal is busy with lengthy output processing, the output may be 
interrupted as follows: 


1. Ready the card reader with the input cards (commands and/or data). 
2. Press TERM RESET. 
3. Press START on the console. 
Note: Due to the nature of the 3780 hardware, print or punch records 
that were in the 3780 buffer when TERM RESET wWas pressed are lost by 


this procedure. The alternative is to wait until the output processing 
has completed. 
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TERMINATING A SESSION 


To terminate a session, the remote terminal operator issues the DRAIN 
command. The link is deactivated after the file currently being 
processed is completed. 


ERROR RECOVERY PROCEDURES 


Most problems you encounter result in lights appearing on the 37280 
console and on the I/O devices themselves. Some lights are not error 
lights; these are DATA SET READY, CARRIER OFF, DATA IN BUFFER, LINE 
MODE, BID, TRANSPCY, MANUAL ANSWER, and any of the I/O device lights 
When on steady. Any blinking I/O device light indicates that the device 
1S not ready. Other lights provide clues to problems and are discussed 
in the following sections. 


Error Recovery for a Line Drop 


If for any reason a line drop occurs, all activity at the remote 
terminal halts. If the terminal was receiving, the printer or punch 
stops. If the terminal was transmitting, the reader stops and RSCS 
closes the partially transmitted file. 


To restart, you must redial the line and reenter your SIGNON card. When 
the SIGNON card is accepted by RSCS, normal line activity resumes. If 
receiving, activity restarts from the point of interruption. If 
transmitting, you can either restart from the file that was interrupted 
or you can send the rest of the data as a separate file. 


If some other user dials in on the disconnected line before you do and 
submits his own SIGNON card, RSCS recognizes the new linkid as being 
different from the one in effect when the line dropped. The new user is 
terminated and the link is deactivated. If your terminal was receiving, 
the printer or punch file is placed at the end of the queue for your 
link and is put into HOLD status. 


To restart under these circumstances, you must first have the RSCS 
operator reactivate your link via the START command. You can then 
redial the line and resubmit your SIGNON card. When the SIGNON card is 
accepted, line activity resumes. Transmission can be either continued 
or restarted. Printer or punch output resumes with the file following 
the one that was active when the line dropped. To process the 
interrupted file, you must change its status from HOLD to NOHOLD via the 
CHANGE command. 
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Error Recovery When Transmitting 


When transmitting, any card reader trouble is indicated by a blinking 
reader light. The following lights on the card reader may further 
indicate the type of trouble: : 
FEED CHECK 
The bottom card in the hopper failed to feed. Remove hopper cards. 
Press NPRO. Repair the bottom hopper card, if necessary, and make 
sure the feed throat is clear. Reload the cards. Press reader 
START and console START. 


ATTENTION 
Full stacker or empty hopper with EOF OFF. Correct the problem, 
press reader START and console START. 


READ CHECK 

VALIDITY CHECK 
Last card in stacker (if no jam) and following card (run out by 
NPRO after hopper cards are removed) must be re-read. After 
appropriate correction, place these two cards at the front of the 
unprocessed cards in the hopper, press reader START and console 
START. 


TERMINAL ADDRESS 
The NPT program is trying to send output While you are trying to 
start an input function. Continue input procedure until you have 
turned on the BID light. Then press CHECK RESET and wait for input 
to begin. Press CHECK RESET if TERMINAL ADDRESS comes on again. 


INPUT CHECK 

BUFFER CHECK 

TRNSPCY CHECK 
With these errors you must always restart the job. Make sure that 
you have turned on the TRANSPCY switch if the input card deck 
contains object decks or other cards requiring transparent 
transmission. 


RECORD CHECK 

LINE CHECK 
These lights may come on while NPT is trying retransmissions for 
line errors; they will go out if recovery is successful. If they 
stay on and the transmission does not proceed, you must do a CHECK 
RESET and restart the input device. The input is continued; 
however, it is possible in this case to have a record duplicated. 


Error Recovery When Receiving 


Output device trouble is indicated by a blinking printer light on the 
console panel or EQUIP CHECK on the 3781 Card Punch panel. 
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FORM CHECK 

CARRIAGE INTERLOCK 

END-—OF—FORM 
The printer carriage, forms, or carriage tape are either not ready 
or jammed. Correct the condition; press CHECK RESET and START on 
the console panel. 


BUFFER CHK 
The printer had a parity error. Press CHECK RESET and START on the 
console panel. Failure to recover indicates hardware trouble. 


EQUIP CHECK 
The punch has mechanically malfunctioned. Make the punch ready 
again. 


When receiving, the following console lights may require your attention: 


TERMINAL ADDRESS 
The NPT program is trying to send output but your 3780 is not 
ready. Make sure your switch setup is correct, ready all output 
devices, and press console CHECK RESET. 


BUFFER CHECK 
This serious hardware error always requires you to reset and 
restart the operation. Failure to recover indicates hardware 
trouble. 


LINE CHECK 
The NPT program is attempting retransmissions. If NPT is 
successful, the light goes out. If the light stays on and printing 
or punching does not continue soon, you must restart the line. 


For other combinations of error lights, consult the publication 


SE ER = CSC = IRENE = Stews 


GA27-3063. 
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Appendix E: Programmable (Spool MULTI-LEAVING) Remote Stations 


This portion contains operational information for each of the following 
remote progammable MULTI-LEAVING stations supported by the SML line 
driver operating in HOST mode under RSCS: 


IBM System/360 

IBM System/370 

IBM System/360 Model 20 

IBM 2922 Programmable Terminal 
IBM System/3 Model 10 Card System 
IBM 1130 System 


The following topics are described as they relate to each station: 
e Supported configuration 

e Remote station processor program functions 

e Operating procedures 

e Error recovery procedures. 

Note: The operating and error recovery procedures for the 
RSCS—-supported programmable remote stations were obtained from the 
publications listed in the Preface. If conflicts occur, refer to the 
latest editions of those publications. 

Another section provides information on the use of the RSCS virtual 
machine as a Remote Job Entry workstation communicating With a 


HASP/ASP-—type batch processor. 


In addition, MULTI-LEAVING Remote Job Entry Workstation (MRJE/WS) 
Support is briefly described for the following remote‘stations: 


IBM System/3 Models 6, 8, 10, 12, and 15 
IBM System/32 


The MRJE/WS support for these systems is described in publications 
listed in the section "IBM System/3 and System/32 as Remote Stations”. 


Et FATS TS as Za 


The following sections contain instructions for operating any model of 
System/360 or System/370 equipped for EBCDIC transmission and binary 
Synchronous communications, as a HASP MULTI-LEAVING remote station. The 
term System/360 is used to refer to both the System/360 and the 
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System/370. 


CONFIGURATION SPECIFICATIONS 


Any System/360 with 8K or more bytes of main storage, a supported 
transmission control unit, and a supported card reader may be used as an 
RSCS remote station. 


The following transmission control units are supported: 


e Integrated Communications Adapter (ICA) on the System/370 Model 135 


e IBM 2701 Data Adapter Unit with Synchronous Data Adapter Type II 


e IBM 2703 Transmission Control Unit with Synchronous Terminal Control 


e IBM 3704 Communications Controller in emulation mode only 


e IBM 3705 Communications Controller in emulation mode only. 


The following ‘unit record devices are supported: 


e IBM 
e IBM 
e IBM 
e IBM 
e IBM 
e IBM 
e IBM 
e IBM 
e IBM 
e IBM 


2540 


2501 


2520 


1442 


1403 


1443 


3203 


3211 


3203 


1052 


Card Read Punch 

Card Reader 

Card Read Punch 

Card Read Punch 

Printer 

Printer 

Printer Model 4 

Printer 

Printer Model 4 (for System/370 Models 138 and 148 only?) 


Printer=Keyboard. 


Communications lines (switched or nonswitched) whose speed 1S compatible 
With the hardware are supported. Only one console (the standard 
operator's console) is supported on each remote station. 


5E-2 
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HASP/RTP360 REMOTE TERMINAL PROCESSOR PROGRAM 


A special program for the IBM System/360 allows it to operate as a 
remote workstation for MULTI-LEAVING operating systems such as HASP and 
ASP. For details on generating the appropriate workstation program, see 
the publication OS/VS2 HASP II Version & System Programmer's Guide, 
GCO27-6992. An IBM System/360 under control of this program and 
communicating with RSCS can be viewed as a logical extension of the 
VM/370 spool system. This program CHASP/RTP360) performs input, output, 


and communication functions. 

HASP/RTP360 can read, print, and punch data concurrently, depending on 
the options selected by the installation and the capabilities of the 
unit record devices. 

Due to the use of blocking and character compression to minimize line 
transmission time, the speed at which the System/360 unit record devices 
operate is dependent on the data being transmitted and the number of 
concurrent functions. Certain job mixes, because of their data 
characteristics, enable HASP/RTP360 to operate the unit record devices 


at near maximum speed. Other job mixes may cause the devices to operate 
in short bursts because of contention on the communications line. 


Input Functions 

HASP/RTP360 provides the following input functions at the remote 
station: 

e Reads from the attached card reader(s) 

e Recognizes operator requests, and reads from the attached console 


e Identifies, compresses, and blocks card images and commands for 
transmission to RSCS 


e Queues blocked records for transmission to RSCS. 


Output Functions 

HASP/RTP360 provides the following output functions at the remote 
station: 

e Dequeues blocked records received from RSCS 

e Identifies the device required for output of the records 


e Deblocks and decompresses output records, queueing the images for 
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printing, punching, or typing 
¢ Prints, punches, and types the output records, as required 


e Sets status flags, indicating backlog conditions on the output 
devices. 


Communication Functions 


HASP/RTP360 provides the following communication functions at the remote 
station: 


e Establishes and maintains synchronization with RSCS 


e Dequeues blocked input requests and transmits them to RSCS (upon 
request from RSCS) 


e Provides backlog status flags, indicating the station's ability to 
receive the various output streams from RSCS 


e Receives output from RSCS and queues the blocked records for 
processing. 


OPERATING PROCEDURES 


The following sections provide information for initiating and operating 
the HASP/RTP360 program during the remote job stream processing session. 
The initiation of a remote job stream processing session involves 
initial program loading of the HASP/RTP360 program deck, establishment 
of the communication lines, and exchange of initial control information 
between RSCS and the HASP/RTP360 program. The initial control sequence 
ends with the passing of the sign-on information from the remote 
station. 


Initial Program Load (IPL) 


To perform the initial program loading of the HASP/RTP360 program deck: 


1. If the power for the System/360 is off, press POWER ON. 


2. Ready the HASP/RTP360 deck in reader 1 (designated by central 
system personnel) and press START and EOF on the reader. (The last 
card of the deck should be blank or a /X*¥SIGNON card, as directed by 
the installation.) 
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10. 


ll. 


Ready printers, punches, and the console. 


Set the LOAD UNIT rotary switches to the device address of reader 
Ive 


Disable the interval timer, if present. 

Set the MODE (RATE) and DIAGNOSTIC (FLT) switches to PROCESS. 

Set CHECK CONTROL to STOP. 

Press SYSTEM RESET and LOAD. 

All cards of the HASP/RTP360 deck are read by the reader. 
HASP/RTP360 prints the /*¥SIGNON card, if present, followed by an 
RSCS environment recording error printout (if the contents of core 


remain unchanged since the last run of the program). 


The remote station 1S now ready to communicate with RSCS. 
HASP/RTP360 Waits While communications are established with RSCS. 


Establishing a Communication Line 


To establish communications With RSCS: 


Ls 


Ready the data set. This involves different actions, based on the 
type of data set. Readying nonswitched lines only requires that 
the data set DATA button be pressed (if present). To ready a dial 
line data set: 


a. Press the TALK button, and lift the receiver off the data set. 

b. Dial the assigned number for the remote station. 

c. If the RSCS line is available, the central system answers with 
a high pitched tone. Press DATA and hang up immediately; the 


data set 15 NOW ready. 


d. If the RSCS line is in use, a busy signal is received. Hang up 
and try again later, or dial an alternative number. 


e. If the call is not answered, the RSCS operator has not given 
the necessary command to authorize use of that communication 
line. Contact the RSCS operator and request that he issue the 


START command for your link. 


When requested by RSCS, HASP/RTP360 begins the initial control 
sequence. 


When the initial sequence is complete, the sign-on information is 
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transmitted to RSCS. HASP/RTP360 “handshakes” with RSCS until the 
processing of job streams actually begins. 2 


Output Processing 


Printing and punching of remote output is handled automatically by the 
RSCS — HASP/RTP360 system, except as controlled by the remote station 
operator or RSCS operator, via commands to RSCS. 


Input Processing 


With the exception of 2520 and 1442 combination reader/punch devices, 
input submission can be initiated at any time from any card reader 
supported by the HASP/RTP360 program. Multiple readers may be used 
concurrently. Place the cards in the input hopper, and press reader 
START. When all of an input stream has been loaded into the hopper, 
press reader EOF to allow the reading of the last cards to signal the 
program that the end of stream has been read. 


program is continually testing each reader and attempting to read cards. 
When any card reader is loaded, HASP/RTP360 immediately reads and 
transmits the cards to RSCS. 


HASP/RTP360 input readers are considered always "hot"; that is, the ) 


— Oe FA || 


Devices with single card paths for both read and punch functions are 
termed combination reader/punches if they are supported for both 
functions. The following are supported combination devices: 
e 1442 Card Read Punch 
e 2520 Card Read Punch 
Dual devices have four basic status conditions that affect the operator: 
1. Neutral -— reader empty during normal program execution. 
2. Input -- reading normal input stream. 
3. Output -—— punching normal output from RSCS. 


4. Output error recovery =—— attempting to recover from punch errors. ) 


At IPL time, the combination device is tn neutral status and may be 
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treated as any reader device, because the operator may submit multiple 
input streams at any time. Any blank cards mixed in the input stream 
are submitted to RSCS as input. When HASP/RTP360 recognizes the 
end-of—file (EOF), the combination device reverts to the neutral status. 


When the combination device is in neutral status, the operator may 
choose to ready the device with blank cards, placing the device in 
output status. If RSCS has output waiting, HASP/RTP360 responds 
immediately by punching the blank cards. However, after all punching is 
finished, or if there is a pause due to low line speeds, the operator 
may not run the remaining cards out of the device and ready it with job 
stream cards. The procedure for interrupting the output mode is: 


l. Press STOP on the device. 


2. Remove the cards from the hopper. (Do not run the cards out of the 
card path.) 


3. Place the input stream cards in the hopper, and press reader START. 


4. If the punch is busy, the device continues punching until the input 
stream is encountered; then, the device enters input status. (It 
is not necessary that all blank cards be removed from the hopper.) 


5. If the punch is momentarily idle, you can cause the device to pass 
one card through by pressing reader STOP and then START. If 
several blank cards are in the hopper in front of the job stream, 
the operation must be repeated for each blank card. 


The combination device is in error recovery status when a punch error 
occurs. HASP/RTP360 attempts to repunch the record in error into the 
following card. If HASP/RTP360 encounters a punched card, a read error 
occurs (see unit record error procedures). The operator should run out 
the input stream cards using the NPRO key, place one or more blank cards 
in front of the input stream, and ready the device. 


Entering Commands 


All messages entered into the 1052 operator's console via the keyboard 

are transmitted to RSCS for action. Although all commands transmitted 

to RSCS are listed on the RSCS operator's console, only those available 
to the remote user are read and acted upon. 


The operator should perform the following steps when entering commands: 
1. Press the REQUEST button on the right side of the keyboard. The 
ATTN indicator Cindicator above the keyboard on the 1052) glows 
momentarily. 
2. When the PROCD indicator comes on, type in the command and press 


EOB (numerical 5 key pressed while ALTN CODING key is pressed). 
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3. If you notice a typing error prior to pressing EOB, press CANCEL 
(numerical Q key pressed while ALTN CODING is pressed) and repeat 
step 2. 


4. If, after receiving a PROCD indicator, no command is to be entered, 
press EOB. 


Terminating a Session 


To terminate remote processing, the remote station operator should enter 
a DRAIN command or a /X*SIGNOFF card which prevents RSCS from initiating 
any more remote output and releases the communication line (if switched) 
When the current print and punch streams are finished. The DATA light 
on the data set goes out and BSCA enters a check condition. For 
nonswitched lines, RSCS makes the line available and waits for an 
initial sequence request from the HASP/RTP360 program. HASP/RTP360 logs 
UNIT CHECK on the console message device. The operator should determine 
Whether printing and punching of output streams have successfully 
terminated and should press STOP on the CPU. To start a new session, 
the operator must perform the steps described previously, starting with 
the Initial Program Load of HASP/RTP360. 


ERROR RECOVERY PROCEDURES 


The following sections indicate some common error conditions and the 
necessary steps for recovery from the errors. 


Communication Adapter Errors 


Due to the design of the synchronization technique for RSCS remote 
stations, no errors are expected during a processing session. The 
unusual occurrence, therefore, of any error condition results from 
either system or communication facility malfunction or from operational 
conditions. In general, the display of error messages is only 
informational, because the station processor automatically initiates the 
appropriate recovery action. A statistical Summary of all errors is 
maintained in the RSCS Environmental Recording Table, and a historical 
report is produced each time HASP/RTP360 is loaded, unless storage has 
been cleared. Additionally, the occurrence of any error causes a 
descriptive message to be displayed immediately on the console 
typewriter. Figure 11 indicates each possible communication error, its 
meaning, and the recovery action taken. 
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Unit Record Errors 


Many of the unit record device errors that can occur during processing 
allow HASP/RTP360 to continue processing without operator intervention. 
Some errors (such as DATA check or END OF FORM) require operator 
assistance before use of the device can be continued. In any event all 
errors occurring on unit record devices are logged in the RSCS 
Environmental Recording Error Printout Table and are displayed 
immediately on the 1052 operator’s console. 


When the error message is printed, you should: 
1. Determine which device is in error (see Figure 12). 


2. Note the device status; if HASP/RTP360 continues to use the device, 
the error message is informative in nature. 


3. Correct the error in accordance with procedures prescribed for the 
device. 


4. Ready the device to resume operation. 
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OlrreedO 


Block sequence check. A transmission If a duplicate, 
block was duplicated or lost. the received block 
rr = received block number is ignored. If a 
expected block number lost block, RSCS 
is signaled to 
restart the job. 


02000000 Negative reply received. A The bad record is 
transmission block Was not correctly retransmitted. 
received by RSCS. 
O3rrrr00 Unknown response received. An RSCS 1s requested 
unrecognizable control character was to retransmit the 
received from RSCS. record. 
rrrr = first two characters received 
(If rrrr is correct sequence, 
ending sequence was bad.) 
04000000 Unit exception. Indicates receipt of RSCS 15 requested 
an EOT character from RSCS. (CEOT is to retransmit the 
not used in MULTI-LEAVING.) record. 
05ss0000 Unit check. A check condition has The failing 
occurred in the communication operation 15 
adapter. retried. If a 
SS = sense byte indicating type of write operation 
check: Was 1M process 
80 Command reject at the time of 
40 Intervention required error, the write 
20 Bus out check 1s reissued; 
10 Equipment check otherwise, RSCS 
08 Data check is requested to 
04 Overrun retransmit. 
02 Lost data 
01 Time out 


06cc0000 Unusual end. An unusual end The failing 
condition has occurred in the operation is 
channel or control unit retried. 
interface. 


cc = CSW byte 5 


07000000 SIO failure. A start I/0 instruction The Start I/0 
Was rejected by the Synchronous Data retried. 
Adapter. 


"Tl 
_ 
Te | 
Cc 
" 
1) 
wr 
wr 
° 


HASP/RTP360 Communication Adapter Error Messages 
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Remote Station Restart 


In the event of an untimely interruption of the remote station operation 
(such aS a machine, program, communications, or environmental failure), 
the remote station operator should notify appropriate maintenance 
personnel of the malfunction and save material that can be used to 
determine the source of the failure. With the aid of the RSCS operator, 
the remote operator should also prepare to restart the station as 
follows: 


1. Notify the central operator of the failure and, if necessary, 
request his assistance in preparing for restart. 


2. Determine, from the RSCS operator’s record, which deck was 
currently being transmitted to RSCS. The input stream, starting 
with that current deck, must be submitted to RSCS after restart. 


3. Determine the loss of data on the output devices and inform the 
RSCS operator to backspace or restart the printer or punch, as 
necessary. (The RSCS link should be made available for a 
subsequent session with the remote station or other stations within 
the system.) 


4. When the remote station iS available, restart the session beginning 
with the Initial Program Load of HASP/RTP360. 
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O05ssOaaa Unit check. Device with address 
"Yaaa™ has unit check error 
described by sense byte "ss" 
and/or indicator lights on the 
device console. 


Sample sense byte settings: 


40 Intervention required Wait for operator. 
10 Equipment check Treat as data check. 
03 Data check — card read, card Depending on device: 
punched, or line printed ignore, retry, or 
incorrectly. wait for operator. 
Carriage control tape Ignore. 
channel 9 encountered on 
printer 


0O6éccOaaa Unusual end. Previous I/O came to Treat as data check. 
an unusual end. IBM customer 
engineer should be consulted. 
cc = CSW byte 5 
aaa = device address 


Note: Printing on a line that has a carriage control tape channel 
9 or 12 punch appears as an error and is logged as an error. The 
installation should place these punches in line positions that do 
not contain print information. Do not eliminate the punches from 
the carriage tape. 


Figure 12. HASP/RTP360 Unit Record Error Messages 


IBM SYSTEM/360 MODEL 20 AND IBM 2922 AS REMOTE STATIONS 


The following section contains instructions for operating the IBM 
System/360 Model 20, equipped with a Binary Synchronous Communications 
Adapter, or the IBM 2922 Programmable Terminal as an RSCS MULTI-LEAVING, 
remote station. All information on the Model 20 also applies to the IBM 
2922 unless a variation is noted. 


CONFIGURATION SPECIFICATIONS 


Any submodel of the Model 20 with at least 8K bytes of main storage, a 
Binary Synchronous Communications Adapter, EBCDIC transmission, Full 
Transparency, and a supported card reader may be used as an RSCS remote 
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station. 


The following unit record devices are supported in any combination: 


IBM 2501 Card Reader 

e IBM 2520 Card Read Punch 

¢ IBM 2560 Multi-Function Card Machine 

e IBM 1442 Card Punch 

e IBM 1403 Printer 

e IBM 2203 Printer 

e IBM 2152 Printer—Keyboard. 

Any speed communication line supported by the hardware (switched or 
nonswitched) is supported. It is recommended (but not required) that a 
submodel 5 be used with high=speed communications lines (19,200 bps and 
greater) for best performance. Other features of the Model 20 that are 
supported but not required include the 2152 Printer—Keyboard; it cannot 
be used on other than a submodel 5 if a high-speed communications line 
(19,200 bps or greater) is used. 

The IBM 2922 is Supported as an RSCS remote station with the same 


package as the Model 20. The standard 2501 Card Reader and 1403 Printer 
available with the 2922 are the Supported input and output devices. 


HASP/RTPM20 REMOTE TERMINAL PROCESSOR PROGRAM 


A special program exists for the IBM System/360 Model 20 and the IBM 
2922 Programmable Terminal which allows them to operate as remote 
Workstations for MULTI-LEAVING operating systems such as HASP and ASP. 


For details on generating the appropriate workstation program, see the 


publication OS/VS HASP II Version 4 System Programmer's Guide, 
GC27-6992. A Model 20 or IBM 2922 under control of this program and 
communicating with RSCS can be viewed a5 a logical extension of the 
VM/370 spool system. This program CHASP/RTPM20) performs input, output, 
and communications functions. 


HASP/RTPM20 can read, print, and punch data concurrently, depending on 
the options selected by the installation and the capabilities of the 
unit record devices. 


Due to the use of blocking and character compression to minimize line 
transmission time, the speed at which the Model 20 unit record devices 
operate depends on the data being transmitted and the number of 
concurrent functions. Certain job mixes, because of their data 
characteristics, enable HASP/RTPM20 to operate the unit record devices 


Appendix E: Programmable Remote Stations 5E-13 


at near full speed. Other job mixes may cause the devices to operate 
short bursts because of contention on the communications line. 


Input Functions 

HASP/RTPM20 provides the following input functions at the remote 
station: 

e Reads from the attached card reader(s) 

e Recognizes operator requests, and reads from the attached console 


e Identifies, compresses, and blocks card images and commands for 
transmission to RSCS 


e Queues blocked records for transmission to RSCS. 


Output Functions 

HASP/RTPM20 provides the following output functions at the remote 
station: 

e Dequeues blocked records received from RSCS 

e Identifies the device required for output of the records 


e Deblocks and decompresses output records, queueing the images for 
printing, punching, or typing 


e Prints, punches, and types the output records, as required 


e Sets status flags, indicating backlog conditions on the output 
devices. 


Communication Functions 


in 


HASP/RTPM20 provides the following communication functions at the remote 


station: 
e Establishes and maintains synchronization with RSCS 


e Dequeues blocked input requests and transmits them to RSCS Cupon 
request from RSCS) 


e Provides backlog status flags, indicating the station’s ability to 
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receive the various output streams from RSCS 


Receives output from RSCS and queues the blocked records for 
processing. 


OPERATING PROCEDURES 


This section provides information for starting and operating the Model 
20 or IBM 2922 during the remote job stream processing session. 


Starting a remote job stream processing session involves initial program 
loading of the HASP/RTPM20 program deck, establishing the communication 
lines, and exchanging initial control information between RSCS and the 
HASP/RTPM20 program. The initial control sequence ends with the passing 
of the sign-on information from the remote station. 


Initial Program Load (IPL) 


To perform initial program loading of the HASP/RTPM20 program deck: 

1. If the power is off, press POWER ON. 

2. Ready the HASP/RTPM20 deck in the supported card reader. (The last 
card of the deck should be blank or a /XSIGNON card, as directed by 
the installation). 

3. Ready the printer, punch, and console (as required). 

4. Set time sharing key down. 

5. Set the address/register data switches to one of the following: 
1F00 — 8K storage 
2FO00 —- 12K storage 
3F00 — 16K storage 

6. Set the mode switch to PROCESS. 


7 + Press LOAD. 


8. All the cards in the HASP/RTPM20 deck are read, except the last 
card. Press reader START to read the last card. 


9. The IPL is complete when the last card is read. HASP/RTPM20 prints 
the /*¥SIGNON card, if present, followed by an RSCS environmental 
recording error printout (if the contents of main storage remain 
unchanged since the last time the program was run). 
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10. The BSCA indicator lights should show periodic transmit and receive 
activity. 


ll. The remote station iS now ready to communicate with RSCS. 


Establishing a Communication Line 


To establish communications with RSCS: 


1. Ready the data set. This involves different actions, based on the 
type of data set. Readying nonswitched lines only requires that 
the data set DATA button be pressed, if present. To ready a dial 
line data set, perform the following: 


a. Press the TALK button, and lift the receiver off the data set. 
b. Dial the assigned number for the remote station. 


c. If the RSCS line is available, the central system answers with 
a high pitched tone. Press DATA and hang up immediately; the 
data set iS Now ready. 


d. If the RSCS line is in use, a busy Signal iS received. Hang 
up, and try again later, or dial an alternate number. 


e. If the call is not answered, the RSCS operator has not given 
the necessary command to authorize use of that communication. 
line. Contact the RSCS operator and request that he issue the 
START command for your link. 


2. When requested by RSCS, HASP/RTPM20 begins the initial control 
sequence. 


3. When the initial sequence is complete, the sign-on function is 


transmitted to RSCS. HASP/RTPM20 "handshakes™ with RSCS until the 
processing of job streams actually begins. 


Output Processing 


The printing and punching of remote output is handled automatically by 
the RSCS — HASP/RTPM20 system, except as controlled by the remote 
station operator or RSCS operator, via commands to RSCS. 
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Input Processing 


A deck can be submitted at any time, depending on the capabilities of 
the card reader/punch combination attached to the Model 20. There is no 
restriction on when the operator can submit a deck stream with the 
following reader/punch combinations: 


1. 2501 Card Reader — 2560 Multi-function Card Machine (secondary 
feed) 


2. 2501 Card Reader — 1442 Card Punch 

3. 2501 Card Read — 2520 Card Punch 

4. 2560 Multi-Function Card Machine (primary feed) — 1442 Card Punch 
5. 2520 Card Read Punch — 1442 Card Punch 


The operator places the cards in the hopper. The reader stops just 
before reading the last card of each job stream. The operator should 
put more cards in the reader or press START on the reader, allowing the 
last card to indicate the end of the input stream. 


The input reader to HASP/RTPM20 is always considered "hot"; that is, the 
program is continually testing the reader and attempting to read cards. 
During this time the appropriate CARD I/0 indicator on the CPU console 
is on (see Unit Record Error Procedures). This condition is not an 
error but indicates that HASP/RTPM20 is ready to send the next input. 


SE TENN = Partie? 


Devices with single card paths for both read and punch functions are 
considered combination reader/punch devices. When using these devices 
as combination devices, the operator must be concerned with the status 
of the device. The following are supported combination devices: 


® 2520 Card Read Punch 


e 2560 MFCM (read — primary feed) 
(punch — secondary feed). 


Note: These devices are not considered combination devices when used in 
combinations listed previously under "Input Processing”. 


OPERATING THE 2520 CARD READ PUNCH: The 2520 has four basic status 


Ee ON EE 


conditions that affect the operator: 
1. Neutral -- reader empty during normal program execution. 


2. Input -—— reading normal input stream. 
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3. Output -— punching normal from RSCS. 
4. Output Error recovery --— attempting to recover from punch errors. 


At IPL time the 2520 is in neutral status and may be treated as any 
reader device; the operator may submit multiple input streams at any 
time. Any blank cards mixed in the input stream are submitted to RSCS 
as input. When HASP/RTPM20 recognizes an end-of-file (EOF), the 2520 
reverts to the neutral status. 


When the 2520 is in neutral status, the operator may choose to ready the 
device with blank cards, thereby placing it in output status. If RSCS 
has output waiting, HASP/RTPM20 responds immediately by punching the 
blank cards. However, after all punching is finished or if there is a 
pause due to low line speeds, the operator may not run the remaining 
cards out of the 2520 and ready it with input stream cards. The 
procedure for interrupting the output mode is: 


Le Press STOP on the 2520. 


2. Remove the cards from the hopper. (Do not run the cards out of the 
card path.) 


3. Place the input stream cards in the hopper and press reader START. 


4. If the punch is busy, the device continues punching until the input 
stream is encountered; then, the 2520 enters the input status. (It 
is not necessary to remove all blank cards from the hopper.) 


5. If the punch is momentarily idle, it is Waiting for local commands 
from the console (if installed). You can cause the 2520 to pass 
one card through by typing on the console ™.SR1”" (start reader 1). 
If several blank cards are in the hopper prior to the input stream, 
you must enter this command for each blank card. For 
configurations Without consoles, you can simulate the .SR1 command 
by setting data dial 2 to numerical value 2 and moving data dial 1 
one position in either direction. Do not move dial 1 twice. Upon 
completion of the skip function, set data dial 2 out of position 2. 


The 2520 is in error recovery status when a punch error occurs. 
HASP/RTPM20 attempts to repunch the record in error. If HASP/RTPM20 
encounters a nonblank card, a read error occurs (see Unit Record Error 
Procedures). You should then run out the input stream cards using the 
NPRO key, place one or more blank cards in front of the input stream, 
and ready the 2520. 


OPERATING THE COMBINATION 2560 MFCM: The 2560 has two baSic status 


CT EA Ea 


conditions: 
1. Input —— submitting decks using primary feed and hopper. 
2. Output —— punching data from RSCS using secondary feed. 


Blank cards, for punching, should always be in the 2560 secondary feed 
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hopper during normal processing. HASP/RTPM20 periodically tests the 
primary feed for input stream cards. If input stream cards are 
encountered, the HASP/RTPM20 suspends the output status and submits the 
input stream to RSCS. You should always press STOP on the combination 
2560 prior to loading the input stream in the primary feed hopper since 
HASP/RMTM20 cycles the feed mechanism when it tests for input stream 
cards. 


Entering Commands 


RSCS commands, as Well as local commands, may be entered at the 2152 
operator's console. Any message entered at the 2152 keyboard and not 
recognized as a local command is transmitted to RSCS for action. 
Although all commands transmitted to RSCS are listed on the RSCS$ 
operator'’s console, only those designated as available to the remote 
user are acted upon. Local commands available to the HASP/RTPM20 
operator signal the status of the unit record devices. Figure 13 lists 
all available local commands. 


Meaning/Comments 


Start reader 1. This command tells HASP/RTPM20 that the 
operator has corrected a data check condition and has made 
the card reader ready to continue reading the input stream 
(the first card 1S a corrected version of the card in 


error). This command is also used to terminate the output 
status of a combination 2520 card reader/punch. 


Start punch 1. This command tells HASP/RTPM20 that the 
operator has removed the incorrectly punched card from the 
punch stacker (1442) and the punch is ready. 


Figure 13. HASP/RTPM20 Local Commands 
Perform the following steps when entering commands: 
1. Press the REQ button located to the right of the console typewriter 
keyboard. The request indicator Cindicator marked "R™ at the right 


of the REQ button) glows momentarily. 


2. When the proceed indicator comes on (indicator marked "P™ below the 
request indicator), type in the command and press EOT. 


3. If you notice a typing error prior to pressing EOT, press CAN 
(cancel) and repeat step 2. 


4. If, after receiving a proceed indicator, no command is to be 
-entered, type ™." and press EOT. This iS recognized as an invalid 
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local command and is ignored. 


Commands are identified by a period (.) in the first position. Except 
for the use of upper and lower case alphabetic characters, the commands 
must appear exactly as listed. No blanks are allowed. 


Terminating a Session 


To terminate remote processing, the remote station operator should enter 
a DRAIN command or /X*SIGNOFF card indicating that RSCS should not start 
any additional remote output and should release the communication line 
Cif switched) when the current print and punch streams are finished. 
The DATA light on the data set goes out, and BSCA enters a check 
condition. For nonswitched lines, RSCS makes the line available and 
waits for an initial sequence request from the HASP/RTPM20 program. 
Versions of HASP/RTPM20 that support console messages log UNIT CHECK on 
the console. The operator should check to see if printing and punching 
of output streams have successfully terminated and should press STOP on 
the CPU. To start a new session, the operator must perform the steps 
described previously, starting with the Initial Program Load of 
HASP/RTPM20. 


ERROR RECOVERY PROCEDURES 


The following sections indicate some common error conditions and the 
necessary steps for recovery from the errors. 


Communication Adapter Errors 


Due to the design of the synchronization technique for RSCS remote 
stations, no errors are expected during a processing session. The 
unusual occurrence, therefore, of any error condition results from 
either a system or a communication facility malfunction or from 
operational conditions. In general, the display of error messages is 
only informational, because the station processor automatically 
initiates the appropriate recovery action. 


A statistical summary of all errors is maintained in the RSCS Environ= 
mental Recording Table, and a historical report is produced each time 
HASP/RTPM20 is loaded, unless storage has been cleared. Additionally, 
the occurrence of any error causes a descriptive message to be displayed 
immediately on the console typewriter. 


Figure 14 indicates each possible communication error, itS meaning, and 
the recovery action taken. 
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OlrreedO 


02000000 


O3rrrr00 


Figure 14. 


Block sequence check. A transmission 


block was duplicated or lost. 
rr = received block number 
expected block number 


Negative reply received. A 
transmission block Was not correctly 
received by RSCS. 


Unknown response received. An 

unrecognizable control character was 

received from RSCS. 

rrrr = first two characters received 
(If rrrr is correct sequence, 
ending sequence was bad.) 


Unit check. A check condition has 
occurred in the communication 
adapter. 
ss = sense byte indicating type of 
check: 
01 Overrun on write 
02 Parity check on write 
81 Overrun on read 
88 = Lost data on read 
90 Time out (no response from 
RSCS in three seconds) 
AO Transmission error 
CoO = EOT received 


Unit Record Errors 


As a result of unit record device errors that 


If a duplicate, 
the received block 
is ignored. Ifa 
lost block, RSCS$ 
is signaled to 
restart the job. 


The bad record is 
retransmitted. 


RSCS is requested 
to retransmit the 
record. 


The failing 
operation is 
retried. If a 
write operation 
Was in process 
at the time of 
error, the write 
is reissued; 
otherwise, RSCS 
is requested to 
retransmit. 


HASP/RTPM20 Communication Adapter Error Messages 


inhibit 1/0, HASP/RTPM20 


continuously tests the device, while performing other functions that can 
continue. Device errors are indicated on the CPU 


follows: 


l. Card I/0 1 =—— 2501 Card Reader 


2. Card I/0 2 -— 
Machine 


3. Card I/O 3 —~— 1442 Card Punch 


indicator panel as 


2520 Card Read Punch or 2560 Multi-Function Card 
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4&, Printer -— 1403 Printer or 2203 Printer 


Indicators on the device control panel indicate the nature of the 
problem. You should correct the error, according to procedures 
prescribed for the device, and then ready the device. HASP/RTPM20 
automatically resumes use of the device. 


Unit record errors that occur during I/0 result in various program 
actions, as shown in Figure 15. 
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C 


Device = 
Function 


Action With Console Action without Console 


2501, 2520, 
2560 — read 


STOP with device address 
in ESTR register?. 


1. Type error message?. 


Wait for .SR1 command. Reread when CPU started. 


Read. 


1442 — punch STOP with device address 


in ESTR register?. 


1. Type error message?. 


Wait for 2. When CPU started, 


repunch record in error. 


-SU1 command. 


Repunch record in 
error. 


2520, 2560 
—- punch 


Select out card in 
error. 


Select out card in 
error. 


Repunch record in 
error. 


Repunch record in 
error. 


2203, 1403 
- print 


Ignore error. Ignore error. 


Ignore first error. Not applicable. 


Wait on next attempt 
to use device’. 


2152 — read Initiate reread. 


Not applicable. 


Wait on next attempt 
to use device?®. 


tError messages are of the form: 0500000a UNIT CHECK, where a is the 
device address of the unit in error. 


2Device addresses correspond to the CPU panel CARD I/0 indicator 
numbers. 


7Console error indicator is cleared by pressing OFF LINE, then 
ON LINE. 


Figure 15. HASP/RTPM20 Action on Unit Record I/O Execution Errors 


When notified of the error via the 2152 console, you should: 
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1. Note the address code in the error message (see Figure 15). 
2. Correct the error for "data check”. 2 
3. Ready the device for program retry of 1/0. 


4. Type the appropriate command (.SR1, .SU1) to signal HASP/RTPM2Z0 
that the device is ready. 


Without the 2152 console, the program stops the CPU with the address of 
the device in the ESTR register. You should (without delay): 


1. Note the address of the device in the ESTR register. 

2. Press STOP on the indicated device. 

3. Press START on the CPU to allow continuation of other functions. 
4. Correct the error for "data check”. 


5. Ready the device for program retry of I/0. 


Remote Station Restart 


In the event of an untimely interruption of the remote station operation an 
(such aS a machine, program, Communications, or environmental failure), 
the remote station operator should notify appropriate maintenance 
personnel of the malfunction, save material that may be of use in 
determining the source of the failure, and (with the aid of the RSCS 
operator) prepare for restarting the station, as follows: 


1. Notify the RSCS operator of the failure and, if necessary, request 
his assistance in preparing for restart. 


2. Determine the current job that was being transmitted to RSCS. (The 
RSCS operator has a record of the deck currently being submitted to 
RSCS.) The input stream, starting with that current deck, must be 
resubmitted to RSCS after restart. 


3. Determine the loss of data on the output devices and request the 
RSCS operator to backspace or restart the printer or punch, as 
necessary. (The RSCS link should be made available for a 
subsequent session with the remote station or with other stations 
on the network.) 


4. When the remote station is available, restart the session beginning 
with the Initial Program Load of HASP/RTPM20. 
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IBM SYSTEM/3 AND SYSTEM/32 AS REMOTE STATIONS 


EE OE 


The IBM System/3 Models 6, 8, 10, 12, and 15, and the IBM System/32 are 
supported as remote work stations by RSCS. 


There are two types of MULTI-LEAVING Remote Job Entry Work Station 
(MRJE/WS) support for the System/3 and System/32. The first, which is 
for the System/3 Model 10 card system only, applies to a program 
produced by VM/370 generation. This program is in the form of a card 
deck, which is punched out at the System/3 and must be loaded to enable 
communication with the host system. This is described in the section 
"IBM System/3 Model 10 Card System as a Remote Station”. 


The second type of MRJE/WS support runs on System/3 Models 6, 8, 10, 12, 
and 15, and on the System/32. This support consists of a group of 
programs that support all System/3 or System/32 input and output 
devices, including disks and tape. This support requires the System/3 
or System/32 System Control Program (SCP) and related MRJE/WS programs. 


Information describing MRJE/WS support for the System/3 is contained in 
the following manuals, which reference other System/3 SCP manuals. 


For System/3 Models 6, 8, 10, and 12: 


IBM System/3 MULTI-LEAVING Remote Job Entry Work Station 


Support Reference Manual, GC21-7621 
Program Logic Manual, SY¥21-0544 

For System/3 Model 15: 

IBM System/3 MULTI-LEAVING Remote Job Entry Work Station 

Support Reference Manual, GC21-5115 
Program Logic Manual, SY21-0521 

The System/32 is supported with the following features: 

e 5320 System Unit (Any Model Al2 through B33) 

e Binary Synchronous Communications Adapter (#2073) 

e System Control Program (5725-SCl1) 


Information describing support for the System/32 is contained in the 
following publications: 


IBM System/32 System Control Programming Reference Manual, 
GC21-7593 


IBM System/32 Operator"s Guide, GC21-7591 
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BM System/32 Data Communications Logic Manual, SY21-0551. 


IBM SYSTEM/3 MODEL 10 CARD SYSTEM AS A REMOTE STATION 


TS ES MT ies Cs iti 0lCe06C SGe 


The following section contains instructions for operating the IBM 
System/3 Model 10 card system equipped with a Binary Synchronous 
Communications Adapter, as an RSCS MULTI-LEAVING remote station. 


CONFIGURATION SPECIFICATIONS 

The System/3 Model 10, with the following features, 1S supported as a 
RSCS remote MULTI-LEAVING work station. 

The minimum System/3 requirements are: 

e 5410 Central Processing Unit (any model) 
e Binary Synchronous Communications Adapter 
e EBCDIC Transmission code 

e Text Transparency 

© 5424 Multi-function Card Unit Cany model) 
e 5203 Printer (any model). 

Supported features are: 


e 1442 Card Read Punch (RPQ 843175 on System/3 5410 CPU and RPQ 841205 
on 1442 Card Read Punch) 


e 5471 Printer Keyboard or 5475 Data Entry Keyboard 

e Universal Character Set on the 5203 Printer 

e Additional Print positions for 5203 Printer 

e §6Any type or speed transmission line available for System/3. 
Recommended features are: 


e 24 or 36 extra print positions on 5203 Printer (to provide standard 
VM/370 print line) 


e Universal Character Set and PN train on the 5203 Printer (to provide 
for standard VM/370 character set) 
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e 5471 Printer-—Keyboard (as a remote operator's console). 


The following features are incompatible with VM/370 support and should 
not be specified: 


e Multi—Point Network Attachment (#9482) 
° USASCII Transmission Code (#9061) 
e Station Selection (#7477). 


All features not specifically prohibited may be attached to the System/3 
but are not supported by the HASP System/3 station processor program. 


HASP/RTPSYS3 REMOTE TERMINAL PROCESSOR PROGRAM 


A special program exists for the IBM System/3 Model 10 card system which 
allows it to operate as a remote work station for MULTI-LEAVING 
operating systems such as HASP and ASP. For details on generating the 
appropriate work station program, see the publication OS/VS2 HASP II 
Version & System Programmer's Guide, GC27-6992. A System/3 under 
control of this program and communicating with RSCS can be viewed as a 
logical extension of the VM/370 spooling system. This program 
CHASP/RTPSYS3) performs input, output, and communications functions. 


HASP/RTPSYS3 can read, print, and punch data concurrently, depending on 
the options selected by the installation and the capabilities of the 
unit record devices. 


Due to the use of blocking and character compression to minimize line 
transmission time, the speed at which the System/3 unit record devices 
operate is dependent on the data being transmitted and the number of 
concurrent functions. Certain job mixes, because of their data 
characteristics, enable HASP/RTPSYS3 to operate the unit record devices 
at near full speed. Other job mixes cause the devices to operate in 
short bursts because of contention on the communications line. 


Input Functions 

HASP/RTPSYS3 provides the following input functions at the remote 
station: 

e Reads from the attached card reader(s) 

e Recognizes operator requests, and reads from the attached console 
e Identifies, compresses, and blocks card images and commands for 


transmission to RSCS 
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e Queues blocked records for transmission to RSCS. 


Output Functions 

HASP/RTPSYS3 provides the following output functions at the remote 
station: 

e Dequeues blocked records received from RSCS. 

e Identifies the device required for output of the records. 


e Deblocks and decompresses output records, queueing the images for 
printing, punching, or typing. 


e Prints, punches, and types the output records, as required. 


e Sets status flags, indicating backlog conditions on the output 
devices. 


Communication Functions 

HASP/RTPSYS3 provides the following communications functions at the 
remote station: 

e Establishes and maintains synchronization with RSCS 


¢ Dequeues blocked input requests and transmits them to RSCS Cupon 
request from RSCS) 


¢ Provides backlog status flags, indicating the terminal's ability to 
receive the various output streams from RSCS 


e Receives output from RSCS and queues the blocked records for 
processing. 


OPERATING PROCEDURES 


This section describes normal operation procedures for the System/3 as a 
Remote Job Entry station. To start a Remote Job Entry session, the 
operator should load the Remote Station Processor (CHASP/RTPSYS3) program 
deck, establish a connection between System/3 and the central comuputer, 
and sign on. 
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Initial Program Load ¢ 


PL) 


EEETIR 


The HASP/RTPSYS3 program deck 
deck of &0-—column cards. 


is either a deck of 96—column cards or a 


To load the 936-—-column load deck: 


ds 


2. 


3. 


4. 


Put the deck 


Press START on the 


Press PROGRAM LOAD 
load selection now 


Press START on the 


MFCU. 


printe 


r. 


To load the 80-—column load deck: 


1. 


2. 


on the System/3. 
must point to MFCU.) 


(For 


in the rightmost card hopper of the MFCU. 


disk systems, the 


Raise the CE controls cover on the System/3. 


With the CE Mode Selector at PROCESS, 


Turn the CE Mode Selector 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


Set 


the 


the 


the 


the 


the 


the 


the 


the 


the 


the 


the 


the 


the 


data knobs to C2, 


data knobs to Ol, 


data knobs to O00, 


data knobs to OO, 


data knobs to 3l, 


data knobs 54, 


data knobs 00, 


data knobs 03, 


data knobs F3, 


data knobs 51, 


data knobs ol, 


data knobs to Fl, 


data knobs to 52, 


Turn the CE Mode Selector 


Press SYSTEM RESET. 
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and press START 


and 


and 


and 


and 


and 


and 


and 


and 


and 


and 


and 


and 


press 


press 


press 


press 


press 


press 


press 


press 


press 


press 


press 


press 


START 


START 


START 


START 


START 


START 


START 


START 


START 


START 


START 


START 


to PROCESS. 
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press SYSTEM RESET. 


once. 


once. 


once. 


once. 


once. 


once. 


once. 


once. 


once. 


once. 


once. 


once. 


once. 
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19. Close the CE Controls cover. 
| 
20. Put the 80—-column load deck in the 1442. J 


21. Press START on the reader, the printer, and the System/3. Cards 
begin reading. 


22. When the reader ready light goes out, press START on the reader. 


Midway through the program deck, the reader stops reading and the 
printer starts printing the HASP Environmental Recording and Editing 
Program (CHEREP), a standard feature of HASP/RTPSYS3. The information 
printed is the content of certain error counters; these counters contain 
a record of the unit checks that occurred during the last remote station 
session. If the counters have been destroyed, one line is printed: 


HEREP COUNTERS HAVE BEEN ALTERED. 


In any case, program loading automatically resumes after printing 1s 
complete. 


Program loading has completed satisfactorily if, when the cards stop 
reading, the console indicator DT TERM READY is ON and either the hopper 
1s empty or the first card in the hopper is not an EOR or /XSIGNON card. 
Decks or blank cards may be stacked behind the program deck. If DDT 
TERM READY is not ON, the last card of the program deck was not an EOR 
or /*SIGNON card, or a card read error occurred. To correct a card read 

error, follow the procedure under halt code F3 in the IBM System/3 Card J 
System Operator's Guide. Ready the hopper, and press the START key (on 
dual programming systems, the PROGRAM LEVEL ONE RESET key) if halt code 
F3 is displayed. 


If the DT TERM READY light is ON and the hopper contains an EOR or 
/*SIGNON card, the operator should remove the cards from the primary 
hopper, press STOP and then NPRO on the reader. The card that was 
stacked when NPRO was pressed is either an EOR or a /XSIGNON card. 
Reload the program deck, making sure that it ends with either the 
correct /x*SIGNON card or a single EOR card. 


Establishing a Communication Line 


The next step in initiating a remote session is establishing a line 
connection between the System/3 and RSCS. The RSCS operator should 
already have issued the RSCS command START linkid, Where linkid is the 
location identifier associated with the System/3. 


If the communication line is nonswitched, make sure that any controls on 
the line’s data set are in the DATA position. The System/3 
automatically establishes communication with RSCS. 
) 


If the communication line is switched, pick up the data set's telephone 
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handset and press the data set's TALK button. Dial the proper telephone 
number and listen for the ring. When the ring 1s answered 
(automatically by RSCS) you will hear a high-pitched tone, followed by 
Silence. Depress the data set's DATA key and hang up the handset. The 
System/3 initiates communications with RSCS and automatically sends it 
the /*SIGNON card. As the /*SIGNON card is being sent, the message: 


COMMUNICATIONS ESTABLISHED 


prints on the 5471 Printer—Keyboard and on the 5203 Printer (if the 5203 
is ready). 


If the System/3 has the Auto-Call feature and the /X¥SIGNON card (or the 
default /xSIGNON card, if not overridden) specifies a telephone number, 
leave the data set in AUTO. The System/3 automatically dials the 
required telephone number. When the number answers, the System/3 
automatically signs on. 


If the call is not answered, or if the System/3 halts with halt code CA 
(call aborted) while trying to auto-call, the trouble is most likely 
that an incorrect telephone number was dialed or specified on the 
/*SIGNON card. It could also be that the RSCS operator did not start 
the correct line. In the latter case, contact the RSCS operator and 
request that he issue the correct START command for your link. 


An auto-call halt CA can occur if the called number is busy. In that 
case, press the console START Cor PROGRAM LEVEL ONE HALT RESET) key to 
repeat the auto—call or redial manually. 


Output Processing 


The remote operator need only press START on the printer to allow 
printing to occur. After a file has reached RSCS, printing starts 
automatically. When a user's printed output iS complete, RSCS queues 
that user's punched output (if any) for processing. 


Notes on the 5203 Printer: 
1. At initial program load time, the system checks indicators of the 
5203 to determine which print chain is mounted. If the indicators 
show a 48 character-set chain, the system assumes character 
arrangement LC; otherwise, it assumes character arrangement PN. 


2. At initial program load time, the system sets the number of print 
lines per page to 66 (may be different for each installation). For 
dual-—carriage printers, the system uses only the left carriage; do 
not press the RIGHT CARRIAGE RESTORE key. 


3. At initial program load time, the system sets line numbers for 


programmed page skipping. These line numbers are provided to 
Simulate the carriage tape control normally encountered in VM/370. 
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A skip to carriage channel 1 results in a page eject; a skip to 

channel 12 stops 5 lines from the bottom of the page; and a skip to 2 
any other channel results in no page movement. Carriage tape 

channels may, however, be defined differently for each 

installation. 


Input Processing 


The remote operator places into a card hopper Ceither 5424 or 1442 card 
reader) a stack of one or more decks and makes the card hopper ready. 
The system reads the first card, finds it punched, and requests 
permission from RSCS to start sending a job stream. When the system 
receives permission from RSCS, it continues reading cards and sending 
them to RSCS. 


If the remote operator is reading cards on the 5424, he may use either 
card hopper. The last card of his stack of decks must be a /xXEOF card 
(the characters /XEQF punched into columns 1-5); this card instructs the 
system to send an end—-of—job-stream indicator to RSCS and to make the 
card hopper dormant. 


If the remote operator is reading from the 1442, he ends the job stream 
by pressing START when the hopper is empty. No special considerations 


apply to preparing or reading 80—column cards. ) 


Operating a Combination Card Read Punch 


—_ Eee Ee ee 


Devices with single card paths for both read and punch functions are 
considered combination reader/punches, if they are supported for both 
functions. The following are supported combination devices on the 
System/3: 


e 54246 Multi-function Card Unit 


° 1442 Card Read Punch. 


Sew ES 


l. Either hopper of the 5424 can be used aS a reader or a punch. When 
a previously dormant 5424 hopper reads a punched card, it becomes a 
reader. It remains a reader until it reads a /XEOF card; it then 
goes dormant with the /xXEOF card in the wait station. 


2. When a previously dormant 5424 hopper reads a blank card, it 
becomes a punch. It remains a punch until it has completed 
punching all decks queued for it. If no decks are queued for it, . 
the operator can make the hopper dormant by removing the blank J 
cards from it. 
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3. The 5424 can read cards much faster than it can punch cards; 
therefore, to increase card throughput, the system performs card 
reading preferentially over card punching. When using both 
hoppers, one aS a reader and one as a punch, punching tends to 
proceed intermittently. 


4. Though the 5424 has two hoppers, it has only one card path. For 
error recovery purposes, the system ensures the card path is empty 
before switching hoppers. Therefore, if the operator is using both 
hoppers as readers, or both as punches, the system tends to process 
cards from one or the other of the hoppers, rather than dividing 
its time evenly between them. 


5. Each blank card to be punched is read before it 1s punched, to make 
sure it is blank. A card that is not blank is stacked in the read 


Stacker for the hopper from Which it came. 


6. Stacker selection is as follows: 


Condition Stacker 
Reading from primary 1 


Punching from primary 
Punching from secondary 
Reading from secondary 


fr Wn 


7. When preparing 96—column cards for the input deck, the operator 
should avoid punching column 81, because the system makes special 
use of this column. In any case, the system only transmits the 
contents of columns 1-80; columns 82-96 are completely ignored. If 
the RMTGEN parameter &S30BJDK was set to 1 when HASP/RTPSYS3 was 
generated, the system inspects column 81. If that column contains 
the character "1", the system assumes that the card contains a 
hexadecimal image of the first 40 bytes of an 80—column card. It 
reads the next card, checks for a "2" in column 81, combines the 
cards into an 80-column card image, and transmits the card image. 
No checks are made for validity of hexadecimal characters. If a 
"2" card does not follow a "1" card, the "1" card is ignored. 


8. Certain punching restrictions are placed on the 5424. For all 
systems, if column 1 is X*6A* (12-11 punch on an 80—column card) 
the system recognizes an RSCS job separator card, extracts the 
spool file number to punch a System/3 job separator card, and 
ignores the rest of the card. If the RMTGEN parameter &S30BJDK was 
specified as 1 when HASP/RTPSYS3 was generated, then the system 
recognizes a card image of an object deck and punches two 96—column 
cards with a hexadecimal representation of the card; see Item 7 
above. If the RMTGEN parameter &S396COL was specified as 1, the 
system recognizes the left 48 columns (if column 80 is odd) or the 
right 4&8 columns (if column 80 iS even) of a 96—column card; in 
this way all 96 columns of a System/3 card can be punched. This 
feature is used to create the System/3 Remote Station Processor 
program deck, which iS punched in System/3 load mode. 


For a detailed description of the RMTGEN macros used in generating the 
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Remote Station Processor program, see the OS/VS2 HASP II Version & 
System Programmer’s Guide. 


1. When a previously dormant 1442 reads a punched card, it becomes a 
reader. It remains a reader until the operator presses the START 
button after the hopper becomes empty (or until it reads a /xEOF 
card); it then becomes dormant. If it became dormant because the 
operator pressed the START button with no cards in the hopper, it 
also runs out the cards in its feed path. 


2. When a previously dormant 1442 reads a blank card, it becomes a 
punch. It remains a punch until it has completed punching all 
files queued for it. Only after all queued decks have been punched 
Can the operator safely remove cards from the 1442 hopper; with the 
hopper empty and no more punching to do, the 1442 becomes dormant. 
Press the NPRO button to stack the two blank cards remaining in the 
card feed path into the right stacker. 


3. All cards processed by the system are stacked into the left 
stacker. 


Entering Commands 


If the System/3 includes a 5475 Data Entry Keyboard or a 5471 Printer— 
Keyboard, the keyboard can be used to enter commands. Otherwise, punch 
the commands on cards and enter them through a reader, exactly as if 
they were jobs. 


The only valid commands from a remote station are a subset of the RSCS 
commands described previously under "Remote Station Operator Commands”. 


ENTERING COMMANDS FROM THE 5471 PRINTER—KEYBOARD: To type a command to 
RSCS, press the REQ key. If the system can immediately allow you to 
type a command, the PROCEED light goes on; otherwise the REQUEST PENDING 
light goes on. You can press the REQ key while you are typing a 
command, while the system is typing a message to you, or while the 


console is dormant. 


When the PROCEED light comes on, start typing the command. If you make 
a mistake, press the CANCEL key and start typing again. 


When you have finished typing, press either the END key or the RETURN 
key; their functions are identical. The command is transmitted to RSCS, 
Where it is executed (if valid) and printed along with the remote 
station number on the RSCS operator's console. 


If the command contains 120 characters, the remote station automatically 
performs the END key function When the 120th character is typed. 
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The 5471 does not type messages if the end-of—forms switch is on. When 
the 5471 runs out of forms, reload forms, press the REQ key, and then 
press the END key. The 5471 resumes typing if there are messages to be 
typed. 


ENTERING COMMANDS FROM THE 5475 DATA ENTRY KEYBOARD: To type a command 
to RSCS, merely start typing on the 5475 Data Entry Keyboard. The 
keyboard is always “alive.” After the first character is typed, the 
column indicator becomes active and displays "02", the position of the 
character to be typed next. If you make a mistake, press the FLD ERASE 


key; the column indicator displays "01" and you can start typing again. 


When you have finished typing, press the REL key to transmit the command 
to RSCS. When the column indicators go dark, begin typing another 
command. If you type a command of 120 characters, the system 
automatically performs the REL key function when you have typed the 
120th character. 


ENTERING COMMANDS FROM CARDS: To send commands to RSCS from a card 
reader, punch the commands, one per card, starting in column 1. Put one 
or more commands cards, followed by a /x®EOF card, into an available card 
hopper and press START. The commands are transmitted along with the 
remote station number and reader number to the RSCS operator’s console. 


The /xXEOF control card consists of the characters "/xEOF"” punched in 
columns 1-5. This control card must be the last card read by an MFCU 
hopper when the hopper is reading, whether decks, commands, or just a 
/*SIGNOFF card is being read. This card may optionally be used on the 
1442 Card Read Punch, but the recommended 1442 procedure is as stated 
previously. 


The EOR control card consists of the characters "EOR™ in card columns 
2-4. It 1s used instead of the /xSIGNON card when the default /x*SIGNON 
card, assembled into the HASP/RTPSYS3 deck, is not to be overridden. 
SYSTEM/3 LOCAL COMMAND PROCESSING: If the System/3 Remote Station 
Processor programs include the local command facility, you can issue 
commands to be executed locally by the System/3. Place a card 
containing the command into any dormant card hopper and press START. Do 


not use a /x*EOF card. 


For each command, the command name starts in column 1 and is followed by 
the operand field. 


Command completion is indicated by one of the following messages, 
printed in the same place as error messages: 


CODE0N000 Command completed satisfactorily 
CODEO0O001 Syntax error in command 


CODE0002 Operand value error in command 
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A /*CARRIAGE command defines printer carriage information. The operand 
field has the format: 


forms—length is the number of print lines on a page of forms (not 
greater than 112). 


chan is the carriage-—channel number (from 1 to 12). 


line-no is the line number at which forms skipping stops for the 
indicated carriage channel (not greater than 
forms—length). 


Notes: 
1. The /*¥CARRIAGE command is effective as soon as it iS read in. 


2. Specification of the L= operand destroys all previous carriage 
channel settings. 


Terminating a Session 


When you are finished using the System/3 as a Remote Job Entry station, 
put into an available hopper the two cards: 


/*¥SIGNOFF 
/*¥E OF 


and press START on the card reader. 


The /¥SIGNOFF card tells RSCS to disconnect the communication line after 
it has finished sending the current print and punch streams to the 
System/3 and after it has finished receiving the current deck from the 
System/3. That is, RSCS disconnects when all currently operating 
functions are complete. If you sign off before RSCS has started 
printing or punching some (Cor all) of your files, RSCS saves the output 
for transmission to your station the next time you sign on with the same 
remote station identification. The DRAIN command can alternatively be 
used to perform the same function. 


When RSCS disconnects the communication line, the System/3 communication 
adapter gets a time-out error every three seconds for about 20 seconds; 
then the DATA light on the data set telephone goes out. When the 
System/3 is dormant, press the STOP button on the console to stop the 
customer meter from running. The current RJE session iS NOW ended. 
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ERROR RECOVERY PROCEDURES 


Two general classes of errors are defined in the System/3 Remote Station 
Processor: communication errors and unit record errors. For either type 
of error, the system generates an 8—-character error message. If the 
system has a 5471 console, error messages are typed on it as they occur. 
If the system does not have a 5471 console, error messages may or may 
not be printed on the 5203 printer, depending on how the Remote Terminal 
Processor program was generated. The format of all error messages is: 


ttxxxxuu 
where tt 1s the message type, xxxx 15 additional error information, and 


uu 1s the device on which the error occurred. The correspondence 
between uu and device is: 


Device uu 
BSCA 00 
1442 05 
5203 OE 
5424 OF 


Communication Adapter Errors 


The communication technique used by RSCS prevents BSCA errors during a 
processing session. Therefore, any BSCA error that occurs While the 
operator is signed on iS an unusual condition, resulting from system or 
communication facility malfunction or operational conditions. For all 
BSCA errors shown in Figure 16, the BSCA processor within the System/3 
Remote Terminal Processor automatically takes corrective action. The 
operator should regard all BSCA error messages only as informational 
messages. 
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OlrreedO A block sequence check occurred. Duplicate transmission 
A transmission block was blocks are lost. Lost 
duplicated or lost. rr is the transmission blocks 
received block number and ee is cause automatic job 
the expected block number. Both restart. 
rr and ee range from X80" to 
RUSE 


02000000 The System/3 received a negative The transmission block 
acknowledgment (NAK) from RSCS. that was negatively 
acknowledged is 
retransmitted. 


O3rrrr00 The transmission block received The System/3 sends a 

by the System/3 had an unrecog- NAK to RSCS, Which then 
nizable starting or ending retransmits the block. 
sequence. The starting sequence 
is rrrr; if it 18 correct, the 
ending sequence 1s in error. 
The System/3 BSCA has a unit The appropriate action 
check. The BSCA status indi- is taken to continue or 
cators are sss5. restore communication. 
For example: 

8000 denotes a timeout error 

8400 denotes a timeout error 

with abortive disconnect 


Figure 16. HASP/RTPSYS3 Communication Adapter Error Messages 


Unit Record Errors 


Unit record error messages are provided for errors on the 1442 Card Read 
Punch Can RPQ device), the 5424 Multi-function Card Unit, and the 5203 
Printer. 


5424 MULTI-FUNCTION CARD UNIT (MFCU): The only MFCU error message is 
O5ssss0OF, where ssss represents the MFCU status indicators. In all 
cases, operator intervention is required. Check the MFCU control panel 


to determine the card hopper to which the error message applies: 


Code Meaning 
PRI Primary Crightmost) card hopper needs attention. 


SEC Secondary (leftmost) card hopper needs attention. 
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The system attempts to perform its previous operation when the operator 
has cleared the error condition: if it was reading when an error 
eccurred, it tries to read the same card again; if it was punching, it 
tries to punch again. Therefore, if the 5424 was punching, the operator 
should throw away the last card punched; if the 5424 was reading, he 
should place the last card read in the hopper again, so the system can 
reread it. First, however, he must lift the cards out of the indicated 
hopper and press the NPRO key to clear the error condition. 


5203 PRINTER: The only 5203 error message is O05ssss0E, where ssss 
represents the 5203 status indicators. If any error light is on at the 
5203 control panel, the operator must correct the condition and press 
printer START. The system automatically retries printing when an 
incrementer failure or print check occurred. 


1442 CARD READ PUNCH: The only 1442 error message is 05ssss05, Where 
ssss represents the status indicators. The system recovers from 1442 
errors the same way it recovers from MFCU errors. The operator should 
perform the action indicated by the 1442 error lights; then, throw away 
the last card punched or place the last card read back in the hopper and 
press START. 


Remote Station Restart 


In the event of an untimely interruption of the remote station operation 
such aS a machine, program, communications, or environmental failure, 
the remote operator should notify appropriate maintenance personnel of 
the malfunction, save material Which may be of use in determining the 
source of the failure, and with the aid of the RSCS operator, prepare 
for restarting the station as follows: 


1. Notify the RSCS operator of the failure and, if necessary, request 
his assistance in preparing for restart. 


2. Determine the current deck that was being transmitted to RSCS. 
(The RSCS operator has a record of the current deck being submitted 
to RSCS.) The input stream starting with the current job must be 
submitted to RSCS after restart. 


3. Determine the loss of data on the output devices and inform the 
RSCS operator to backspace or restart the printer or punch as 
necessary. (The RSCS link should be made available for subsequent 
session with the remote station or other stations within the 
system.) 


G. When the remote terminal is available, restart the session 
beginning with the Initial Program Load of HASP/RTPSYS3. 
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IBM 1130 SYSTEM AS A REMOTE STATION 


PET ET § EE 8 | Ee 8 ERY 60 MADIRSST OUEST 


The following section contains instructions for operating an IBM 1130 
System, equipped with a Binary Synchronous Communications Adapter, as a 
RSCS MULTI-LEAVING remote station. 


CONFIGURATION SPECIFICATIONS 


Any model of the 1130 (except Models 4A and 4B) with at least 8K words 
of storage, the Synchronous Communications Adapter, and any card reader, 
may be used as a RSCS remote station. All standard readers, printers, 
and punches available for the 1130 system are supported in any combina- 
tion. The console printer/keyboard is supported as a limited remote 
operator's console. Any standard communication line (switched or 
nonswitched) of any speed iS supported. The RPQ feature that allows the 
use of high-speed communication facilities iS not supported. 


HASP/RTP1130 REMOTE TERMINAL PROCESSOR PROGRAM 


A special program exists for the IBM 1130 that allows it to operate as a 
remote workstation for MULTI-LEAVING operating systems such as HASP and 
ASP. For details on generating the appropriate workstation program, see 
GC27-6992. An 1130 System under control of this program and communica— 
ting with RSCS can be viewed as a logical extension of the VYM/370 spool 
system. This program (CHASP/RTP1130) performs input, output, and 
communication functions. 


HASP/RTP1130 can read, print, and punch data concurrently, depending on 
the options selected by the installation and the capabilities of the 
unit record devices. 


Due to the use of blocking and character compression to minimize line 
transmission time, the speed at which the 1130 unit record devices 
operate is dependent on the data being transmitted and the number of 
concurrent functions. Certain job mixes, because of their data 
characteristics, enable HASP/RTP1130 to operate the unit record devices 
at near maximum speed. Other job mixes can cause the devices to operate 
in short bursts because of contention on the communications line. 


Input Functions 


HASP/RTP1130 provides the following input functions at the remote 
station: 
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e Reads from the attached card reader(s) 
e Recognizes operator requests, and reads from the attached console 


e Identifies, compresses, and blocks card images and commands for 
transmission to RSCS 


° Queues blocked records for transmission to RSCS. 


Output Functions 

HASP/RTP1130 provides the following output functions at the remote 
station: 

¢ Dequeues blocked records received from RSCS 

¢ Identifies the device required for output of the records 


¢ Deblocks and decompresses output records, queueing the images for 
printing, punching, or typing 


e Prints, punches, and types the output records, as required 


e Sets status flags, indicating backlog conditions on the output 
devices. 


Communication Functions 


HASP/RTP1130 provides the following communication functions at the 
remote station: 


e Establishes and maintains synchronization with RSCS 


e Dequeuves blocked input requests and transmits them to RSCS (upon 
request from RSCS) 


e Provides backlog status flags, indicating the terminal's ability to 
receive the various output streams from RSCS 


e Receives output from RSCS and queues the blocked records for 
processing. 
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OPERATING PROCEDURES 


The following sections provide information for initiating and operating 
the HASP/RTP1130 program during the remote job stream processing 
session. 


The initiation of a remote job stream processing session involves 
initial program loading of the HASP/RTP1130 program deck, establishment 
of the communication lines, and exchange of initial control information 
between RSCS and the HASP/RTP1130 program. The initial control sequence 
ends with the passing of the sign-on information from the remote 
station. 


Initial Program Load (IPL) 


To perform the initial program loading of the HASP/RTP1130 program deck: 


1. Ready the HASP/RTP1130 deck in the primary card reader (do not 
place decks behind the HASP/RTP1130 deck). If two cards readers 
exist, be sure the second 1s not in ready status. 


2. Ready all printers. 
3. Set the STR/BSC switch to BSC. 


4. Set the line speed control to the appropriate value (1200, 2000, 
2400, etc.?). 


5. Verify that the rotary CPU control switch is set to the RUN 
position. 


6. Press IMM STOP, RESET, and PROGRAM LOAD on the 1130 console. 


7. After the last card has been read, the card reader goes out of 
ready status. Ready the card reader (press START on the reader 
until it becomes ready) and press START on the 1130 console. The 
last card should be the END card of the HASP/RTP1130 deck, a 
/*SIGNON card or a REP card. All unidentified cards are ignored. 


8. Establish the communications line. 
Note: The message DATA SET NOT READY is printed after the 
execution of Item 7 if the data set is not ready and establishing 


the communications line 1s not possible. 


9. Processing can then begin in the full MULTI-LEAVING mode. 
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Establishing a Communication Line 


The procedures for establishing communications with RSCS are as follows: 


1. Ready the data set. This involves different actions, depending on 
the type of data set. For nonswitched lines when the BSC RDY 
indicator is on, no action iS required. Certain nonswitched lines 
require that the data set DATA button be pressed. To ready a dial 
line data set, perform the following: 


a. Press the TALK button and lift the receiver on the data set. 
b. Dial the assigned number for the remote station. 


c. If the RSCS line is available, the central system answers With 
a high pitched tone. Press DATA and replace the receiver 
immediately (the data set 1S now ready). 


d. If the RSCS line is in use, a busy Signal is received. Replace 
the receiver and try again later, or dial an alternate 
communications line number. 


e. If the call is not answered, the RSCS operator has not given 
the necessary RSCS command (START) to authorize use of that 
communication line. Contact the RSCS operator and request that 
he issue the START command for your link. 


2. When the data set is ready, the BSC RDY indicator is on. When 
requested, HASP/RTP1130 begins the initial control sequence. The 
REC and TSM lights alternate during normal operation. 


3. When the initial sequence is complete, control information is 
transmitted to RSCS and "handshaking™ (with the REC and TSM lights 
alternating) continues. In addition, the message: 


COMMUNICATION LINE ESTABLISHED 


is printed on the console typewriter. 


Output Processing 


The printing and punching of remote output is handled automatically by 
the HASP/RTP1130 system, except as controlled by the remote station 
operator or RSCS operator via commands to RSCS. 


OUTPUT PROCESSING ON THE 1442 CARD READ PUNCH: A system with the 1442 


defined as a punch-only device requires no operator action other than a 
ready condition and blank cards in the hopper. 
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Input Processing 


Card decks can be submitted at any time, depending on the capabilities 
of the card reader/punch attached to the 1130 System. 


The 2501 Card Reader allows the cards to be placed in the hopper as 
desired. The reader stops after reading the last card in the hopper and 
the message INTERVENTION REQUIRED ON 2501 is printed on the console 
printer. The operator may then press START on the reader to terminate 
the input stream or load more cards in the hopper, press START and 
continue the input stream. The intervention message is typed whenever 
the 2501 goes from a ready condition to a not ready condition. 


The input reader to HASP/RTP1130 is considered always "hot™; that is, it 
1s continually testing the reader and attempting to read cards. 


INPUT PROCESSING ON THE 1442 CARD READ PUNCH: The function of the 1442 
Card Read Punch is defined via operator action at the keyboard/console. 
Initially, the 1442 Card Read Punch is considered to be a card reader. 


When punch data is transmitted to the 1130 System, a message is printed: 


PUNCH PROCESSOR WAITING FOR 1442 


The operator may then define the 1442 as a punch by entering the 
command: 


-DPUNCH ¢ or .DP) 


This specification 1s needed for each job that transmits punch data to 
the station. 


When defined as a reader by issuing the command 
-DREADER Cor .DR) 


the 1442 retains the assignment until a .DPUNCH 1s given. As a reader 
the 1442 operates like the 2501 Card Reader. 


Note that during input processing on the 1442 Card Read Punch: 


e The .DPUNCH and .DREADER commands result in no action if the opposite 
function is active when the command is issued. 


e Defining the 1442 Card Read Punch as a punch with input cards in the 


hopper and punch data available from RSCS destroys the data in the 
Input cards. 
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Entering Commands 


RSCS commands and local commands may be entered at the remote station’s 
console. Any message entered at the keyboard, which is not recognized 
as a local command, is transmitted to RSCS for action. Although all 
commands transmitted to RSCS are listed on the RSCS operator's console, 
only those designated as being available to the remote user are acted 
upon. 


ENTERING RSCS COMMANDS: The remote station operator should perform the 
following steps when entering RSCS commands: 


1. Press the INT REQ button which is located to the right of the 
console typewriter keyboard. 


z2. When the K.B. Select indicator comes on, type in the command, and 
press EOF. 


3. If a typing error is noticed before pressing EOF, press the ERASE 
FIELD key, and repeat step 1. 


Note that the BACKSPACE key is processed in the same manner as the ERASE 
FIELD key. 


ENTERING LOCAL COMMANDS: The following local commands can be entered at 
the remote station's console: 


-DR Defines the combination 1442 Card Read Punch as a reader. This 


definition remains in effect until a .~.DP command is entered and 
accepted. 


-DP Defines the combination 1442 Card Read Punch as a punch. This 
definition remains in effect for one output only. The function 
next assigned is dependent on the entering of another .DP or .DR. 

Local Commands are identified by a period in the first available type 

position. No blanks are allowed in the body of a command. Acceptance 

of a console command is signaled by the message: 
OK! 


Rejection is signaled by the message: 


WHAT ? 


Terminating a Session 


To terminate remote processing, the remote station operator can send a 
/*SIGNOFF card through the card reader input stream or issue the DRAIN 
command. This tells RSCS not to initiate the sending of any more remote 
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output and to release the communication line (if DIAL) when the current 
print or punch stream is finished. The RDY light on the data set goes 
out, and an SCA log message Code 3 is released periodically. The 
operator should ensure that printing and punching of output streams have 
successfully terminated and then press STOP on the CPU. To start a new 
session, the operator must perform the steps described previously, 
starting with the Initial Program Load of HASP/RTP1130. 


ERROR RECOVERY PROCEDURES 


The following sections indicate some of the common error conditions that 
can arise and the necessary steps required for recovery. 


Communications Adapter Errors 


Due to the design of the synchronization technique for RSCS remote 
Stations, no errors are expected during a processing session. The 
eccurrence, therefore, of any error condition is an unusual condition 
resulting from either system or communication facility malfunction or 
operational conditions. In general, the display of error messages is 
only informational, since HASP/RTP1130 automatically initiates the 
appropriate recovery action. A list of error messages that may be 
displayed on the console printer is shown in Figure 17. 


Unit Record Errors 


Many of the unit record device errors that can occur during processing 
allow HASP/RTP1130 to continue processing without operator intervention. 
Some errors, such as DATA check and END OF FORM, require operator 
assistance before use of the device can be continued. In any event, all 
errors occurring on unit record devices are logged in the RSCS 
Environmental Recording Error Printout Table and are displayed 
immediately on the 1052 operator’s console. 


When the error message is printed, you should: 
1. Determine which device is in error (see Figure 18). 


2. Note the device status; if HASP/RTP3690 continues to use the device, 
the error message is informative in nature. 


3. Correct the error in accordance with procedures prescribed for the 
device. 


4. Ready the device to resume operation. 
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FFrreed0 Block sequence check. A If duplicate, the 
transmission block was received block is 
duplicated or lost. ignored. If the 
rr = received block number block is lost, SML 

expected block number restarts the job. 

O2dddd00 Abnormal read complete. The 
number of bytes requested have 
been read, but no end sequence 
was detected. 


O3dddd00 Timeout while attempting to 
| synchronize an initial sequence 
O04dddd00 Received timeout While reading SML is requested to 
data. retransmit the record. 
O5dddd00 BCC compare error after normal 
read complete condition. 
06dddd00 Data overrun. Program can't read 
data before next character is 
received from transmission line. 
07dddd0od Data set not ready. Discovered HASP/RTP113 waits for 
at interrupt time. data set to become 
ready and then resumes 
operation on the line. 


038ddddo00 Error on initial read. First SML 1S requested to 
character not SOH, DLE, ENQ, or retransmit the record. 
NAK ...0or... SOH—-STX, DLE-STX, 
or DLE-ACKO pair not found. 
09dddd00 NAK received. Last data recorded is 
| retransmitted to SML. 
OBdddd0O | Single DLE found in transparent 
| data. 
OCdddddo ENQ received after initial SML is requested to 
Sign-on sequence. retransmit the record. 
OddddbDOO No pad character following NAK. 


Note: dddd = device status word received for the Synchronous 
Communication Adapter 


Figure 17. HASP/RTP1130 Communication Adapter Error Messages 
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05ss0aaa Unit check. Device with address 
"aaa" has unit check error 
described by sense byte "ss" 
and/or indicator lights on the 
device console. 


Sample sense byte settings: 


40 Intervention required Wait for operator. 
10 = Equipment check Treat as data check. 
08 = Data check — card read, card Depending on device: 
punched, or line printed ignore, retry, or 
incorrectly. wait for operator. 
Carriage control tape Ignore. 
channel 9 encountered on 
printer 


06cc0aaa Unusual end. Previous I/O came to Treat as data check. 
an unusual end. Service 
personnel should be consulted. 
= CSW byte 5 
aaa = device address 


Note: Printing on a line that has a carriage control tape channel 
9 or 12 punch appears aS an error and is logged aS an error. The 
installation should place these punches in line positions that do 
not contain print information. Do not eliminate the punches from 
the carriage tape. 


Figure 18. HASP/RTP1130 Unit Record Error Messages 


Remote Station Restart 


In the event of an untimely interruption of the remote station operation 
(such as a machine, program, communications, or environmental failure), 
the remote station operator should notify appropriate maintenance 
personnel of the malfunction. He should also save material that may be 
of use in determining the source of the failure and, with the aid of the 
RSCS operator, should prepare for restarting the station, as follows: 


1. Notify the RSCS operator of the failure and, if necessary, request 
his assistance in preparing for restart. 


2. Determine the current deck being transmitted to RSCS. (The RSCS 
operator has a record of the current deck being submitted to RSCS.) 
The input stream, starting with that current deck, must be 
submitted to RSCS after restart. 
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3. Determine the loss of data on the output devices, and inform the 
central operator to backspace or restart the printer or punch, as 
necessary. (The RSCS link should be made available for a 
subsequent session with the remote station or other stations within 
the system.) 


4. When the remote station is available, restart the session beginning 
with the Initial Program Load of HASP/RTP1130. 


Load Process Unusual Conditions 


The first eight cards of the 1130 remote station deck are the bootstrap 
loader (RTPBOOT), that loads the main loader (RTPLOAD) into upper 1130 
storage. RTPLOAD then loads the main station deck CHASP/RTP1130), 
processes REP cards (if any), and processes the /*SIGNON card (if 
included). 


Figures 19 and 20 describe the unusual conditions that may occur during 
execution of RTPBOOT and RTPLOAD. 


Error Indication Error Description Operator Action 


System loop at location RTPBOOT—computed sum Loading of RTPLOAD 
"AAT with IAR displayed (checksum) of columns is permanently 
at location ‘"AB’. 1-72 of last card read terminated. Note 


does not match value card being 

in columns 73-74, processed, and 
previously computed contact system 
during RTPLOAD programmer or 

generation. lead operator. 


System loop at location RTPBOOT detected Same as above. 
"AE’ with TAR illegal punch in the 

displaying location RTPLOAD card just read, 

"AF®. AC contains card or the last four cards 

code value of column in of RTPBOOT contain an 

error. XR2Z contains 2s illegal EBCDIC punch. 

complement of card 

column in error. 


Figure 19. HASP/RTP1130 Loading Errors (RTPBOOT) 
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Error Indication Error Description Operator Action 


The last REP card read 
contained a format 


System wait at location 
"0010". AC displays 
MPEP S? < 


Loading is 

permanently 
terminated. Note 
that a card 
error and contact 


value error. 


1s in 


system programmer 


or lead operator. 


System wait at location 
"0010". AC displays 
TERR 2s 


RTPLOAD-—computed sum 
(checksum) of columns 
1-72 of last 
HASP/RTP1130 card read 
does not match value 
in columns 73-74, 
previously computed. 


Loading may be 
resumed by 
pressing START on 
11320 console. 
Unpredictable 
results may occur. 
Best action is to 
note card in error 
and contact system 
programmer or lead 


value 


operator. 


To start 
HASP/RTP1130 

processing, press 
START on the card 
reader until 

ready; then press 
START on the 1130 
console. 


This 1S not an error. 
The last card has been 
read by the 2501 or 
1442, and operator 


action 15 required. 


System wait at location 
"0010". AC displays 
TPEP LY < 


value 


Figure 20. HASP/RTP1130 Loading Errors (RTPLOAD) 


Local Message Summary 


Messages printed on the console typewriter originate from RSCS or are 
generated by HASP/RTP1130, in conjunction with the station operation. 
Messages from RSCS have the three-character prefix DMT; they are printed 
in red if the red/black typewriter ribbon is installed. 


Local messages (typed in black) are listed in Figure 21 along with a 
detailed explanation of each message. 
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INTERVENTION Where xxxx 18 1442, 2501, 1403, or 1132. This 
REQUIRED ON message indicates that the indicated device has 

x XX gone from a read to a "not ready™ condition, 
usually because the device was manually stopped 
or because the device requires operator action 
(for example, cards or paper). The device should 
be serviced as required and made ready to 
continue operation. 


PUNCH PROCESSOR 
WAITING FOR 1442 


This message 1s issued whenever punch data is 
waiting to be punched on a system equipped with a 
combination Card Read Punch. If the 1442 is 
defined as a reader, it must complete the read 
function before it can be defined as a punch. 

If the 1442 is defined as a punch, no further 
action (other than providing blank cards and 
making the device ready) is8 necessary. 


DATA SET 
NOT READY 


This message is issued when the communications 
adapter signals HASP/RTP1130 that the attached 
telephone data set 1S in a "not ready” condition. 
The program does not attempt to use the 
communication adapter until a “ready” condition 

1s detected. All other functions (card input, 
typewriter, etc.) continue until they reguire the 
service of the data set. If the data set was 

made "not ready” by manual intervention, operation 
may be resumed by making it ready. 


CAUTION: The RSCS machine may print error messages 
that could cause the operator to restart the 
communications line. In this event, the 
HASP/RTP1130 program must be reloaded. 


SCA LOG xxxxxx00 


Indicates an unusual condition associated with the 
SCA (Synchronous Communication Adapter). 


COMMUNICATION 
LINE ESTABLISHED 


Issued when the HASP/RTP1130 program is 
initialized and when communications have been 
established with the RSCS machine. 


WHAT ? Response any local command not recognized or 
accepted by HASP/RTP1130. 
OK? Response any local command recognized or 


accepted by HASP/RTP1130. 


Figure 21. IBM 1130 Local Messages 
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RSCS AS A REMOTE JOB ENTRY STATION 


a Re EF TA EO Ken 


The RSCS virtual machine, through an SML line driver operating in RJE 
mode, can act as a MULTI~LEAVING Workstation. In this capacity, RSCS 
accepts job files that are either spooled to it by VM/370 virtual 
machines or received from other nodes in the network. It then transmits 
the job files, via the SML line driver, to the remote batch system for 
processing. Qutput received from the remote system is sent to the real 
printer or punch of the directly connected VM/370 system. 


CONFIGURATION SPECIFICATIONS 


Any of the System/370 Models 135, 135-3, 138, 145, 145-3, 148, 155 II, 
158, 165 II, and 168, or a 3031, 3032, 3033, or 4300 Processors with at 
least 240K of processor storage, a minimum of two direct access storage 
devices, and equipped with a transmission control unit Supported by 
RSCS, can be used as a remote job entry station to access a remote batch 
processor. The supported transmission control units are: 


e Integrated Communications Adapter (ICA) with Synchronous Data Adapter 
Type II on the System/370 Model 135 


e IBM 2701 Data Adapter Unit with Synchronous Data Adapter Type II 
e IBM 2703 Transmission Control Unit with Synchronous Terminal Control 
e IBM 3704 Communications Controller in emulation mode only 


e IBM 3705 Communications Controller in emulation mode only. 


SML AS THE REMOTE TERMINAL PROCESSOR (RTP) PROGRAM 


For a system or device to function as a MULTI-LEAVING Workstation, a 
Remote Terminal Processor (RTP) program must be loaded to provide the 
software functions of input, output, and communication according to the 
protocol established by the host batch processor. An SML line driver 
task, operating in RJE mode, provides these functions for RSCS when it 
is to act as a workstation for a remote batch system. 


Input Functions 


The SML line driver, operating in RJE mode, provides the following input 


functions at the RSCS virtual machine: 
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e Accesses job files received by RSCS from VM/370 virtual machines or 
remote stations (either workstations or remote NJI/NJE systems) 


e Accepts batch system commands entered at the RSCS operator's console 
(RJE mode only) 


e Compresses and blocks card images and commands into transmission 
records according to the protocol requirements of the batch system 


e Transmits the blocked records to the remote batch system. 


Output Functions 
The SML line driver, operating in RJE mode, provides the following 
output functions at the RSCS virtual machine: 


e Deblocks and decompresses transmission records received from the 
remote system 


e Identifies the device required for output 


e Spools the output to the real printer and/or punch, as well as to the 
virtual machine specified in the output, for RJE mode 


e Directs messages from the remote batch system to the RSCS operator's 
console, 


OPERATING PROCEDURES 


With the exception of the initialization and sign-on procedure, the 
operation of RSCS as a MULTI-LEAVING Workstation is similar to that 
described under the section "IBM System/370 as a Remote Station”. 


Starting the SML Line Driver 


After the RSCS virtual machine is logged on and RSCS is loaded, the RSCS 
operator can start the SML line driver. 


Issue the START command for the link to the remote batch system. 


If the link attributes in the link table are appropriate for this 
session, the START command can be issued as: 
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START linkid Parm < [Bnnnn] [password] 


A description of the START command operands, including those that 
override previous definitions, is in the section "Starting an SML Line 
Driver (DMTSML)™, "Part 3: RSCS Operation”™. 

The Hrn, Rrn, and Arn operands specify the type of remote batch system 
CHASP, RES, or ASP) and the workstation number or name that Was assigned 


to RSCS when the remote system was generated. 


For HASP Cor JES2), rn is a number from 1 through 99; the entry could 
look like: H3, H20, or H43. 


For RES, rn is also a number from 1 through 99; the entry could look 
like: R2, R50, or R77. 


For ASP Cor JES3), rnis a five=character alphameric name; the entry 
could look like: ANEWYK, ABURLS, APOK16, or A62121. 


Successful execution of the START command results in the message: 


DMTSML141I LINE ‘vaddr’ READY FOR CONNECTION TO LINK ‘linkid’ 


Establishing a Communication Line 


If the line identified by vaddr in the previous message is a nonswitched 
line, the line connection is automatically completed and the following 
message 7S issued: 

DMTSML142I LINK *linkid’ LINE ‘vaddr’ CONNECTED 

If the line is a switched line, the RSCS operator should: 


l. Press the TALK button, and lift the receiver off the data set. 


2. When you hear the dial tone, dial the telephone number of the 
remote system. 


3. If the line is available, the remote system answers with a high 
pitched tone. Press DATA and hang up immediately; the data set is 
now ready and the DMTSML142I message is issued. 


G4. If the line is in use, a busy signal is heard. Hang up and try 
later, or dial an alternate number. 
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5. If the call is not answered, the remote system operator has not 
given the necessary command to authorize use of that communication 
line. Contact the remote system operator and request that he issue 
the appropriate START command for your workstation. 


When requested by the remote system, the SML line driver begins the 
initial control sequence. When the initial Sequence is complete, the 
sign-on procedure is performed. 


Signing On to the Remote System 


In RJE mode the SML line driver builds a SIGNON record from information 
in the RSCS START command. This record is then sent to the remote 
system for validation. When accepted, the SML line driver "handshakes"” 
With the remote system until processing of job streams and output data 
actually begins. 
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Appendix F: VSE/Power Remote System Connection 


The RSCS virtual machine, through the POW line driver, provides a 
connection to a remote DOS/VSE batch system running VSE/POWER, using the 
POWER MULTI-LEAVING line protocol. In this capacity, RSCS accepts job 
files that are either spooled to it by VM/370 virtual machines or 
received from other nodes in the network. It then transmits the job 
files, via the POW line driver, to the remote batch system for 
processing. Output received from the remote system is sent to the real 
printer or punch of the directly connected VM/370 system. 


GENERATING VSE/POWER FOR THE RSCS CONNECTION 


The following is an example of DOS/VSE JCL which generates and catalogs 
a basic VSE/POWER system for connection to an RSCS system. Refer to the 
VSE/POWER Installation and Operations Guide, SH12~-5329, for details of 
the VSE/POWER generation procedure. 


Sample Job: 


// JOB POWGEN 
// OPTION CATAL 
// EXEC ASSEMBLY 


POWER CPUID=2 (see note ]l]) 
PLINE ADDR=X'028",POW2=YES (see note 2) 
PRMT TYPE=POWER,REMOTE=1 (see note 3) 
END 

/* 

// EXEC LNKEDT 

/* 

/ & 

Notes: 


1. Specifies 2 as the remote CPUID of the VSE/POWER system. 

2. POW2=YES is required for connection to RSCS on the line specified by 
ADDR=. 

3. Specifies 1 as the remote CPUID of the RSCS system. This corresponds 
to the Cnnn parameter of the RSCS START command for DMTPOW. 


CONFIGURATION SPECIFICATIONS 


The following transmission control units are supported for the 
connection between processors running VM/370 with RSCS and DOS/VSE with 
VSE/POWER: 
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e IBM 2701 Data Adapter Unit with Synchronous Data Adapter Type II 
e IBM 2703 Transmission Control Unit with Synchronous Terminal Control 
e IBM 3704 Communications Controller in emulation mode only 


e IBM 3705 Communications Controller in emulation mode only. 


INPUT FUNCTIONS 
The POW line driver provides the following input functions at the RSCS 
virtual machine: 


e Accesses job files received by RSCS from local virtual machine users 
or remote nodes in the network. 


e Compresses and blocks card images, messages, and commands into 
transmission records according to the protocol requirements of the 


batch system. 


e Transmits the blocked records to the remote batch system. 


OUTPUT FUNCTIONS 
The POW line driver provides the following output functions at the RSCS 
virtual machine: 


e Deblocks and decompresses transmission records received from the 
remote VSE/POWER system. 


e Identifies the output requirements (for example, device type, output 
class, number of copies). 


e Spools the output to the real printer and/or punch. 


e Directs messages from the remote batch system to the RSCS operator's 
console. 


OPERATING PROCEDURES 


To establish the connection to the VSE/POWER system, the RSCS operator 
must: 
e Establish the connection by issuing the START command to initiate the 


Signon procedure. 
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¢ Provide for return of job output from the VSE/POWER system by issuing 
the CMD command to cause activation of VSE/POWER writer tasks. 


Having established the connection, the RSCS operator interacts with the 
line driver via existing RSCS operator commands. 


STARTING THE POW LINE DRIVER 

After the RSCS virtual machine is logged on and RSCS is loaded, the RSCS 
operator can start the POW line driver. 

Issue the START command for the link to the remote batch system. 


If the link attributes in the link table are appropriate for this 
session, the START command can be issued as: 


START linkid [Parm [Cnnn] [/password] ] 


A description:of the START command operands, including those that 
override previous definitions, 15 in the section "Starting a POW Line 
Driver (DMTPOW)™, "Part 3: RSCS Operation”. 


Successful execution of the START command results in the message: 


DMTPOW141I LINE ‘vaddr’ READY FOR CONNECTION TO LINK ‘linkid’ 


ESTABLISHING A COMMUNICATION LINE 


If the line identified by vaddr in the previous message is a nonswitched 
line, the line connection is automatically completed and the following 
message is issued: 

DMTPOW142I LINK *linkid’® LINE "‘vaddr’ CONNECTED 

If the line i5 a switched line, the RSCS operator should: 


a a Press the TALK button, and lift the receiver off the data set. 


Zz. When you hear the dial tone, dial the telephone number of the 
remote system. 


3. If the line is available, the remote DOS/VSE system answers With a 
high pitched tone. Press DATA and hang up immediately; the data 


set 1S Now ready and the DMTPOW142I message is issued. 


4. If the line is in use, a busy signal is heard. Hang up and try 
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later, or dial an alternate number. 


5. If the call is not answered, the remote DOS/VSE system operator has 
not given the necessary command to authorize use of that 
communication line. Contact the DOS/VSE operator and request that 
he issue the appropriate PSTART command for your system. 


The POW line driver then begins the initial control sequence. When the 
initial seguence is complete, the sign-on procedure is performed. 


SIGNON PROCEDURE FOR THE REMOTE VSE/POWER SYSTEM 


The POW line driver internally interacts with the VSE/POWER system to 
perform the sign-on procedure. When completed, the following message is 
issued: 


DMTPOWS9O5I SIGNON OF LINK "linkid*® COMPLETE 


The POW line driver then “handshakes” with the remote system until 
processing of job streams and output data actually begins. 


RETURN OF JOB OUTPUT TO RSCS 


Since VSE/POWER does not provide for the unsolicited return of job 
output, the RSCS operator must request transmission of listings and 
punched output from the DOS/VSE system. In order to accomplish this, a 
START command for the appropriate POWER output tasks must be issued. 


After message DMTPOW905I (SIGNON COMPLETE) has been issued, the RSCS 
operator can start the LST or PUN output tasks with the CMD command. 
The RSCS operator can stop the transmission of output from VSE/POWER 
and/or change the output class by using the POWER START and/or STOP 

commands. 


The CMD command (for linkid POWER) is issued as follows: 


START 
CMD POWER S LST [,class(es)] 
STOP PUN 
P 
where: 
START or §S initiate a writer task in the VSE/POWER system for list or 


punch output. 
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STOP or P terminates an active writer task in the VSE/POWER system. 


LST specifies a writer task for printed output. 
PUN specifies a writer task for punched output. 
Class(es) is an optional parameter for specifying up to four output 


classes for list or punch output. Classes may be 
specified as A-Z. If omitted, the default is class A. 


Note: These correspond to the classes supported at the 
local VM/370 system. 


TERMINATION OF THE VSE/POWER CONNECTION 


To terminate the connection to the remote VSE/POWER system, the RSCS 
operator issues the DRAIN or SHUTDOWN command for the link. This causes 
the POW line driver to send an internal command to the VSE/POWER system 
to stop its RJE input task. The POW line driver then deactivates 
itself. 


If the DOS/VSE system operator stops the RJE task on the VSE/POWER 
system, or issues a PEND to terminate VSE/POWER, an internal command is 
sent to the POW line driver causing the following message to be issued: 


DMTPOWS45I1 LINK "linkid’® DEACTIVATION INITIATED BY POWER 


The POW line driver is then deactivated. 
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Appendix G: Base Tape Contents 


The following describes the contents of the RSCS Base Tape at First 
Customer Ship. The contents of the service tapes vary depending upon 
service activity. Therefore, you should refer to the user memo on the 
service tape (the second file) for this level of information. 


1. Base Tape Loading EXEC 


FILENAME FILETYPE FUNCTION 


RSCSBASE EXEC Load other files from the tape 


SAMPLE DIRECT Sample Directory 
PROFILE SAMPLE Sample Profile 
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2. Required Data 


FILENAME FILETYPE FUNCTION 


DMTLOAD EXEC Loadlist for RSCS Nucleus 
DMKLDOOE LOADER VM Nucleus Loader Program 
LDT DMTINIW Indicates Where to Start Loading 
RSCS CNTRL Control File for use With VMFASM or VMFLOAD 
DMT AKE TEXT Task Communication — Take Module 
DMTASK TEXT Task Supervision — Create & Delete 
DMTASY TEXT Task Supervision — Task Asych. Exits 
DMTAXA TEXT Accounting 
DMT AXM TEXT CP SPOOL Interface Module 
DMTAXS TEXT Preloaded Spooling Task Manager 
DMT CMX TEXT Commands — Routing 
DMT CMY TEXT Commands — Routing (Part 2) 
DMTCOM TEXT Routines -=- Reent.: GETPAGE, FREEPAGE, GETLINK 
DMTCRE TEXT Task Supervision — Create New Tasks 
DMTDSP TEXT Dispatcher 
DMTEXT TEXT Interrupt Handler — Exteranl 
DMTGIV TEXT Task Communication — Give Module 
DMTINI TEXT Initialization 
DMTIOM TEXT I0S & 10 Interrupt Handler 
DMTIRX TEXT Initialization — Non—-MSUP, Transient 
DMTLAX TEXT Line Allocation Task 
DMTMGX TEXT Message Processing 
DMTMIN TEXT Initialization — MSUP 
DMTMSG TEXT Messages - No Code 
DMTNCM TEXT Line Driver — NJE/NJI on BSC or CTC 
DMTNHD TEXT Network Routines — Commands, MSGS, Header Rtns 
DMTNIT TEXT Line Driver Init. — For DMTNJI 
DMTNJI TEXT Preloaded NJI Line Driver 
DMTNPT TEXT Line Driver — 2770, 2780, 3770, AND 3780 
DMT POW TEXT Line Driver — MLI to VSE/POWER 
DMTPRE TEXT Utility — Combine, Link, and Relocate Text Decks 
DMTPST TEXT Task Supervision — Post Routine 
DMTQRQ TEXT MSUP Status Queue Manager 
DMTREX TEXT REX Supervisor Task—-PC'S, Lock Mgr, Timer, ROUTE 
DMTRGX TEXT Commands — CMD & MSG Routing Processor 
DMTRPT TEXT Line Driver — 3270 Information Display 
System Printers 
DMTSIG TEXT Task Communication — Task Alert Exit 
DMTSML TEXT Line Driver — RJE Work Sta. With MULTI-LEAVING 
DMTSTO TEXT Storage Mgt —- Reserves Pages of Free Storage 
DMTSVC TEXT Interupt Handler — SVC 
DMTVEC TEXT Low Storage Def. from X*'200" 
DMT VMB TEXT Line Driver — BSC CP SPOOL File Transmission 
DMTVMC TEXT Line Driver — CTC CP SPOOL File Transmission 
DMTWAT TEXT Task Supervision — Wait Module 
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3. Tools for Servicing RSCS 


FILENAME FILETYPE FUNCTION 


DMTMAC EXEC Loadlist to build DMTMAC MACLIB 


DMT AXS EXEC Loadlist to preload DMTAXS TEXT 
DMTNJI EXEC Loadlist to preload DMTNJI TEXT 
PRELOAD MODULE Module to build DMTAXS and DMTNJI 
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RSCS Module Source Code 


DMTSVC 
DMT VEC 
DMT VMB 
DMT VMC 
DMTWAT 


ASSEMBLE 
ASSEMBLE 
ASSEMBLE 
ASSEMBLE 
ASSEMBLE 


DMT AKE ASSEMBLE Task Communication — Take Module 
DMTASK ASSEMBLE Task Supervision — Create & Delete 
DMTASY ASSEMBLE Task Supervision — Task Asych. Exits 
DMT AXA ASSEMBLE Accounting 
DMT AXM ASSEMBLE CP SPOOL Interface Module 
DMT CMX ASSEMBLE Commands — Routing 
DMT CMY ASSEMBLE Commands — Routing (Part 2) 
DMTCOM ASSEMBLE Routines — Reent.: GETPAGE, FREEPAGE, GETLINK 
DMTCRE ASSEMBLE Task Supervision — Create New Tasks 
DMT DSP ASSEMBLE Dispatcher 
DMT EXT ASSEMBLE Interrupt Handler — Exteranl 
DMTGIV ASSEMBLE Task Communication — Give Module 
DMTINI ASSEMBLE Initialization 
DMTIOM ASSEMBLE TOS & I0 Interrupt Handler 
DMTIRX ASSEMBLE Initialization — Non-MSUP, Transient 
DMTLAX ASSEMBLE Line Allocation Task 
DMTMGX ASSEMBLE Message Processing 
DMTMIN ASSEMBLE Initialization — MSUP 
DMTMSG ASSEMBLE Messages - No Code 
DMTNCM ASSEMBLE Line Driver —- NJE/NJI on BSC or CTC 
DMTNHD ASSEMBLE Network Routines — Commands, MSGS, Header Rtns 
DMTNIT ASSEMBLE Line Driver Init. — For DMTNJI 
DMTNPT ASSEMBLE Line Driver — 2770, 2780, 3770, AND 3780 
DMTP OW ASSEMBLE Line Driver — MLI to VSE/POWER 
DMTPRE ASSEMBLE Utility — Combine, Link, and Relocate Text Decks 
DMTP ST ASSEMBLE Task Supervision — Post Routine 
DMTQRQ ASSEMBLE MSUP Status Queue Manager 
DMTREX ASSEMBLE REX Supervisor Task 
DMTRGX ASSEMBLE Commands — CMD & MSG Routing Processor 
DMTRPT ASSEMBLE Line Driver — 3270 Information Display 
System Printers 
DMTSIG ASSEMBLE Task Communication — Task Alert Exit 
DMTSML ASSEMBLE Line Driver — RJE Work Sta. With MULTI-LEAVING 
DMTSTO ASSEMBLE Storage Mgt — Reserves Pages of Free Storage 


Interupt Handler — SVC 

Low Storage Def. from X"'200’ 

Line Driver — BSC CP SPOOL File Transmission 
Line Driver —- CTC CP SPOOL File Transmission 
Task Supervision — Wait Module 


5. RSCS Macro Library 


FILENAME FILETYPE FUNCTION 
DMTMAC MACLIB RSCS Macro Library 
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6. 


RSCS Macro and Copy Source Code 


FILENAME FILETYPE FUNCTION 


SNCC 
SNHD 
SNMR 
DIAG 
FREEZE 
MLXI1REC 
MLX2REC 
MLX3REC 
VNETMSG 
ASYNE 
AZALERT 
BQELM 
BUFF 
CMSACCES 
DEVTYPES 
FREEE 
GIVEE 
IOE 
IOTABLE 


LINKTABLE 


L3ALERT 
NJEEQU 
OUTDEVT 
RCMELM 
ROUTE 
RSSEQU 
SPOOL 
SVECTORS 
TAG 
TANK 
TAREA 
TASKE 
TCT 


Network Connection Control Record 
Network Job and Data set Header Records 
Network Message Record 

Diagnose Interface to VM/370 
Stops Tasks and Saves Status 
VSE/POWER MLX1 Format 

VSE/POWER MLX2 Format 

VSE/POWER MLX3 Format 

Generates RSCS Message Format and Routine 
Asynch Interrupt Request Element 
Format A2 Alert Element 

Message and Command Queue Element 
Telecommunications Buffer 

CMS Read Access Method Table 
VM/SP Device Type Equates 

Free Queue Element 

Give Request Element 

I/O Element 

I/O Table 

Link Table Entry 

Format L3 Alert Element 

NJI Line Driver Equates 

Output Device Table Entry 

Message and Command Routing Element 
Routing Table Entry 

RSCS and CP Equate Symbols 

VM/SP SFBLOK and SPLINK 

Low Core Definitions 

TAG 

Unit Record Tank 

Task Save Area 

Task Element 

Task Control Table 
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The abbreviations used 


ASP 
BSC 
BSCA 
CMS 

CP 

CPU 
CSW 
CTCA 
DASD 
DOS/VSE 
EBCDIC 
EDF 
HASP 
HEREP 
I/O 
ICA 
IPL 
JCL 
JECL 
JES 

MF CU 
MFT 
MRJE/WS 
MVS 
MVT 
NJE 
NJI 
NPT 

OS 
OS/VS1 
OS/VS2 
PLC 
PRPQ 
RES 
RJE 
RSCS 
RTP 
SsIo 
SML 
SVS 
VNET 
VSE/POWER 
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in this manual are: 


Asymmetric Multiprocessing System 

Binary Synchronous Communication 

Binary Synchronous Communication Adapter 
Conversational Monitor System 

Control Program (in VM/370) 

Central Processing Unit 

Channel Status Word 

Channel—to-Channel Adapter 

Direct Access Storage Device 

Disk Operating System/Virtual Storage Extended 
Extended Binary-—Coded Decimal Interchange Code 
Enhanced Disk Format 

Houston Automatic Spooling System 

HASP Environmental Recording and Editing Program 
Input/Output 

Integrated Communications Adapter 

Initial Program Load 

Job Control Language 

Job Entry Control Language 

Job Entry Subsystem 

Multi-Function Card Unit 

Multiprogramming with a Fixed Number of Tasks 
MULTI-LEAVING Remote Job Entry Workstation 
Multiple Virtual Storage (OS/VS2 Release 2 and above) 
Multiprogramming with a Variable Number of Tasks 
Network Job Entry 

Network Job Interface 

Nonprogrammable Terminal 

Operating System 

Operating System/Virtual Storage 1 

Operating System/Virtual Storage 2 

Program Level Change 

Programming Request for Price Quotation 

Remote Entry Services 

Remote Job Entry 

Remote Spooling Communications Subsystem 
Remote Terminal Processor 

Start Input/Output 

Spool MULTI-LEAVING 

Single Virtual Storage (OS/VS2 Release 1.x) 
VM/370 Networking 

Virtual Storage Extended/Priority Output Writers, 
Execution Processors, and Input Readers 
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*% (comment) command 3-7, 5A—4 


abbreviations 5H-1 
accounting 
record 1-8 

activating a link 3-4, 5A-25 
active files 3-4 
adding a new link 3-3, 5A-10 
altering attributes of a file 
attaching the RSCS tape 2-15 
automatic command execution 

facility 1-8 
auxiliary storage 1-3 

AXS task 1-10 


BACKSPAC command 3-6, 5A—-4% 
base tape contents 2-12, 5G-1 
copy source code 5G-5 
loading exec 5G-1 
macro library 56-4 
macro source code 5G-5 
module source code 56-3 
required data 5G-1 
sample directory 5G-1 
sample profile 56-1 


3-5 


tools for servicing RSCS 5G-2 


utility program 5G-1 
BSC (binary synchronous 
communications) line protocol 
1-11 
buffer size 3-22, 3-25 
building RSCS 2-20 


CHANGE command 3-5, 5A—-5 
changing 

spool file attributes 5A-5 

the link table 3-32 

the routing table 3-32 
CKD-—-type DASD 1-3 


Clearing files enqueued on a link 


3-6 
CLOSE command 3-6, 5A-7 
CMD command 3-6, 5A-8 
command 

* (comment) 3-7 


Index 


BACKSPAC 3=— 
CHANGE 3-5 
CLOSE 3-6 
CMD 3-6 

CP 3-7 
CPQUERY 3-8 
DEFINE 3-3 
DELETE 3-3 
DISCONN 3-8 


6 


DRAIN 3-3 
EXEC 3-8 
FLUSH 3-5 
FORCE 3-3 
FREE 3-3 
FWDSPACE 3-6 
HOLD 3-3 

HT 3-8 

MSG 3-7 
ORDER 3-5 
PURGE 3-5 
QUERY 3-9 
REORDER 3-5 
ROUTE 3-4 
SHUTDOWN 3-4 
START 3-4 


TRACE 3-10 
TRANSFER 3-5 


commands 


communication 3-6 
file control 3-% 
link and line control 3-2 
miscellaneous 3-7 
notational conventions 5A-1 
passing to the VM/370 control 
program 3-7 
RSCS operator 3-2 
RSCS operator 
* (comment) S5A—-4% 
BACKSPACE S5A-4 
CHANGE S5A-5 
CLOSE 5A-7 
CMD 5A-8 
CP S5A-9 
CPQUERY S5A-9 
DEFINE S5A~-10 
DELETE S5A-12 
DISCONN S5A-12 
DRAIN 5A—13 


Index I-1l 


EXEC S5A-13 


FLUSH 5A-14 
FORCE 5A-15 
FREE S5A-15 
FWDSPACE 5A—-16 
HOLD SA-16 
HT 5A-17 
MSG 5A-17 
ORDER S5A-18 
PURGE 5A-19 
QUERY S5A-19 
REORDER S5A-24% 
ROUTE S5SA-24% 
SHUTDOWN 5A-25 
START 5A-25 
TRACE 5A-28 
TRANSFER 5A-29 
sending to a remote system 
5A-8 


transmitting to VM/370 control 

program 5A-—-9 

user 4-2 
comments, placing on the RSCS 
operator's console 3-7, 5A—4 
communicating with JES2 NJE 
systems 3-11 
communication commands 3-6 
communication links 1-7 
components of RSCS 1-10 
connect statement 3-11 
control statement 


LINK 2-5 
LOCAL 2=4 
PARM 2-6 
PORT 2-7 
ROUTE 2-6 
TAGS 2-7 
control 
file 2-24 


tasks 1-10 
copy source code 5G-5 
CP command 3-7, 5A-9 
CPQUERY command 3-8, 5A-9 


deactivating a link 3-3 
after processing current file 
5A-13 
and terminating its line driver 
task 5A-15 
deactivating files 5A-7 
DEFINE command 3-3, 5A=10 
defining 


a new link 5A-10 
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an entry in the RSCS routing 
table 3-4, 5A-24 

staging disks 2-19 

your RSCS virtual machine 2-13 


DELETE command 3-3, 5A-12 
deleting 
a link 5A-12 


a link definition 3-3 
an entry in the RSCS routing 
table 3-4, 5A-24% 
differences, operating 3-33 
directory (RSCS DIRECT) 1-6, 2-2 
control statements 2-3 


LINK 2-5 
LOCAL 2-4 
PARM 2-6 
PORT 2-7 
ROUTE 2-6 
TAGS 2-7 


examples 2-4, 2-8, 2-9, 2-10 
DISCONN command 3-8, 5A-12 
disconnecting the RSCS operator's 

console 3-8, 5A-12 
discontinue processing current 
file on the link 3-5 
displaying status information 
5A-19 
DMTNJI line driver 3-11 
(see also NJI) 
DMTNPT line driver 
(see NPT) 
DMTPOW line driver 
(see POW) 
DMTRPT line driver 
(see RPT) 
DMTSML line driver 
(see SML) 
DMTVMB line driver 
(see VMB) 
DMTVMC line driver 

(see VMC) 

DRAIN command 3-3, 5A-13 
dynamic reconfiguration 3-32 


examples, user 4-12 
examples 
file handling 1-5 
managing a file rejected by 
RSCS due to an incorrect 
address 4-21 
RSCS directory 2-4, 2-8, 2-9, 
2-190 
RSCS job submission 


and Operations 


to a VSE/POWER batch 
processor 4-19 
with special output 
processing 4-20 
RSCS output transmission using 
special forms 4-20 
sending a file 
to a list of remote VM/370 
users 4-16 
to a remote VM/370 user 
4-14 
SMSG use 4-22 
specifying destination of 
VM/370 virtual output 4-12 
spooling 4-12 
tagging 4-12 
using an EXEC file to simplify 
your entries 4-13 
VM/370 directory entry for an 
RSCS virtual machine 2-13 
EXEC command 3-8, 5A-13 
executing a sequence of commands 
5A-13 
executing frequently used 
sequences 3-8 


file control commands 3-4 
file handling example 1-5 
file information obtained by QUERY 
command 3-9 
file processing 
NPT 3-23 
POW 3-20 
file transmission 3-2 
resuming 3-3 
suspending 3-3 
file 
repositioning 5SA-4 
spool 
changing attributes S5A-5 
transmission, resuming 5A-15 
file:control 2-24 
files, pending 2-2 
files 
active 3-4 
deactivating 5A-7 
inactive 3-4 
pending 2-7 
redirecting 5A-29 
removing from a queue 5A-19 
reordering 5A-24% 
respositioning 5A-16 
specifying class of those 


transmitted by the link 2-5 
suspending for a particular 
link 5A=-16 
fixed block mode DASD 1-3 
FLUSH command 3-5, 5A-14 
flushing files on a 3270 printer 
3-27, 3-28 
FORCE command 3-3, 5A-15 
FREE command 3-3, 5A-15 
FWDSPACE command 3-6, 5A-16 


generating RSCS 2-14 
attaching the RSCS tapes 2-15 
linking to the RSCS mini—-disk 
2-15 
logon 2-14 
modifying the supplied PROFILE 
RSCS 2-17 
modifying the supplied RSCS 
directory 2-17 
generating VSE/POWER for the RSCS 
connection 5F-1 


halt processing of a file being 
transmitted 5A-14% 

header card formats for the VM/370 
real reader 3-12 

HOLD command 3-3, 5A—-16 

HOST mode of the SML line driver 
1-12 

HOST mode 3-17, 3-18 

HT command 3-8, 5A-17 


IBM system/3 5E-25 
Model 10 SE-26 
configuration specifications 
5E—-26 
error recovery procedures 
5E-37 
HASP/RTPSYS3 remote terminal 
processor program 5E-27 
operating procedures 5E-28 
IBM system/32 5E-25 
IBM system/360 and system/370 
5E-1 
configuration specifications 
5E-2 
error recovery procedures 5E-8 
HASP/RTP360 remote terminal 
processor program 5E-3 
operating procedures 5£E-4 


Index I=-3 


IBM system/360 Model 20 S5E-12 
configuration specifications 
5E-12 
error recovery procedures 
5E-20 
HASP/RTPM2Z20 remote terminal 


processor program 5E-13 
operating procedures 5E-15 
IBM 1130 5E—-40 
configuration specifications 
5E-40 
error recovery procedures 
5E-46 


HASP/RTP1130 remote terminal 
processor program 5E-40 
operating procedures 5E-42 

IBM 2770 5D-1 
entering commands 5D—-3 
error recovery procedures 5D-3 
operational notes 5D-2 
supported configuration 5D-1 
terminating a session 5D-3 

IBM 2780 5D-—-6 
entering commands 5D-7 
error recovery procedures 5D-7 
operational notes 5D—-6 
supported configuration 5D-—6 
terminating a session 5D-7 


IBM 2922 5£E-12 
configuration specifications 
5E-12 
error recovery procedures 
5E-20 


HASP/RTPM20 remote terminal 
processor program 5E-13 


operating procedures 5E-15 
IBM 3770 S5D-11 
entering commands 5D-14 


error recovery procedures 
5D-14 


operational notes 5D-13 
supported configuration 5D-11 
terminating a session 5D-14% 


IBM 3780 5D-15 
entering commands 5D-16 
error recovery procedures 
5D-17 
interrupting output processing 
5D-16 
operational notes 5D-16 
supported configuration 
terminating a session 
ID card format from remote 
stations 3-12 


5D-15 
5D-17 


inactive files 3-4 
initialization messages 5B-—76 
input file processing 3-23 
installation 2-12 

considerations 2-11 

planning for 2-2 
installing RSCS 2-12 
introduction 1-2 


job output routing 
capabilities 1-23 
options 1-24 
overview 1-23 
job submission 
RSCS, to an MVS JES2/NJE batch 
processor 4-17 


LAX task 1-10 
line activity, monitoring 3-10 
line control commands 3-2 
line driver, restarting a 3-31 
line driver 

descriptions 1-9 

NJI 3-11, 3-30 


NJI 1-21 
NPT 3-21 
NPT 1-16 
POW 1-14 


signing on 3-20 

starting 3-19 
RPT 1-19 

starting 3-24 
selection 2-10 
SML 1-11 

signing on 3-17 

starting 3-15 
supported functions 
task 1-6, 1-10 

specifying name of 2-5 
types of 1-8 


2-10, 2-11 


VMB 1-20 
starting 3-238 

VMC + 3=29 

VMC 1-20 


line drivers 1=8, l-11 
LINK (control statement) 2-5 
link control commands 3-2 
link 
communication 1-7 
definitions 1-7 
information, obtained by QUERY 
command 3-9 
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table 1-7 
linking to the RSCS mini-disk 
2-15 
links 

activating 5A-25 
loading RSCS 2-20 
LOCAL (control statement) 2-4 
logon 2-14 


macro library 56-4 
macro source code 5G-5 
manual Workload leveling 1-8 
messages 
code identifiers 3-11 
format 5B-1 
in response to commands 5B-68 
initialization 5B-76 


NPT 3-24 

RSCS 3-10 

sending to a remote station 
5A-17 

sent to VM/370 user’s console 
4-24 

SML 3-19 


spontaneous 5B-67 
summary 5B—-66 
suppressing 3-8 
suppressing printing of 5A-17 
text 
*locid’ INVALID ROUTE 
SPECIFIED 5B—-41 
*locid’ NOT ROUTED 5B-4&2 


*locid’ NOT ROUTED -— ROUTE 
--- 5B-42 

*locid’ NOW ROUTED THROUGH 
~e- 5B-41 

"locid’ ROUTED THROUGH LINK 
--- 5B-42 

"nn! FILE(S) CLOSED ON LINK 
so2 -~SB=32Z 

"nn’ FILE(S) PURGED ON LINK 
oe. 5B-43 

*nn’ FILE(S) TRANSFERRED ON 
--- 5B-43 

"nn? PENDING FILES FOR LINK 
--- 5B-7 

userid’ NOT LOGGED ON 
5B-19 

"userid’ NOT RECEIVING 
5B-19 

ACCEPTED BY TASK ‘task’ 
5B-16 


ACTIVATING LINK ‘linkid’® ... 


5B-52 
ACTIVE FILE ‘'spoolid’ 
SENDING ... 5B-11 
CONFLICTING KEYWORD 
*keyword’ 5B-15 
CONFLICTING OPTION ‘keyword’ 


«3s. -5B=15 

DECOMPRESSION ERROR ON LINK 
--- 5B-65 

DEV *cuu’ IS NOT A LINE PORT 
--- 5SB-53 


DIRECTORY ENTRY OUT OF ORDER 
5B-23 

DRIVER ‘type’ FILE FORMAT 
--- 5B-54 

DRIVER ‘type’ NOT FOUND ON 
--- 5B-53 

DUPLICATE LINK ID 5B-24% 

DUPLICATE LOCATION ID 5B-24 

DUPLICATE PORT ADDRESS 

5B-24 

EXEC 'filename’ FILE FORMAT 
--- 5SB-51 

EXEC 'filename*® IN EXECUTION 
see, SB=-51 

EXEC *filename’ NOT FOUND 
--- SB—-50 

EXECUTING 'filename’ 
COMMAND: ... 5B—-51 

FATAL ERROR LOADING DMTAXS 
5B-29 

FATAL ERROR LOADING DMTLAX 
5B-30 

FATAL ERROR LOADING FROM ... 
5B-54 

FATAL ERROR READING FROM ... 
5B-51 

FATAL ERROR READING R;‘ ee 
5B-29 

FILE (’orgid’) SF ED 12 
--- 5B-6 

FILE "spoolid’ (C’orgid") 
*locid’ ‘userid’ CL a PR pp 
LEFT mmmmmmmm... 5B—-46 

FILE "*spoolid’ ('*orgid") 
Tlocid’ ‘userid’ CL a PR pp 


REC nnnnnnnn... S5SB-45 
FILE *spoolid’® ('orgid") 
ENQUEVED... 5B-5 


FILE "spoolid’ (*orgid’) 
PENDING... 5B-—5 

FILE "spoolid’ (*orgid’) | 
REJECTED 5B-5 

FILE "Spoolid’ ACTIVE —— ... 
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5B-34 

FILE "*spoolid’ ACTIVE ON ... 
5B-47 

FILE *spoolid’ BACKSPACED 
5B-32 

FILE *spoolid’ CHANGED 
5B-33 

FILE *spoolid’ FL ... 5B-48& 

FTLE *spoolid’ FORWARD 
SPACED 5B-39 

FILE *spoolid*® HELD FOR LINK 
-+. 5B-33 

FILE *spoolid’ INACTIVE -—- 
ee 5B-32 

FILE "*spoolid’ INACTIVE ON 
--- 5B—-46 

FILE *spoolid’® IS FOR LINK 
--- 5B-34 

FILE *spoolid’ MISSING —— 
Sis. SB=7 

FILE ‘'spoolid* NOT ACTIVE 
5B-38 

FILE "*spoolid’ NOT FOUND 
5B-48 

FILE *spoolid’ NOT FOUND —— 


NO ACTION... 5B—34 

FILE "'spoolid’ ORG "locidl’ 
~-- 5B—47 

FILE "spoolid’ PR pp CL a 
--- 5B-47 

FILE "*spoolid’ PROCESSING 
--- 5B-38 


FILE "spoolid* PURGED 5B—6 

FILE *spoolid" RELEASED FOR 
--- 5B-33 

FILE PURGED BY USER ... 
5B-—64 

FILE QUEUE REORDERED 5B—7 

FREE STORAGE = ‘nn’ PAGES 
5B-2 

FROM ‘locid'’C"userid'’): ... 
5B-13 

FROM *locid’: (message text) 
5B-12 

I/O ERROR cuu SIOCC cc CSW 


ex SB=3s 

ID CARD MISSING ON LINK ... 
5B-64 

INCORRECT PASSWORD RECEIVED 
--- SB-61 

INDIRECT ROUTING FOR ‘%locid’ 
--- 5B—41 

INITIALIZATION FAILURE —— 
--- 5SB—-4 


INTERVENTION REQUIRED ON 
PRINTER... 5B~63 

INVALID "PARM" PARAMETER ... 
5B-59 

INVALID BUFFER PARAMETER —— 
~-. 5B-59 

INVALID CLASS SPECIFICATION 
5B—-27 

INVALID COMMAND "*command' 
5B-—14 

INVALID CYL/BLK NUMBER — ... 
5B-28 

INVALID DEVICE ADDRESS — ... 
5B-28 

INVALID DIRECTORY ENTRY 
5B-22 

INVALID DRIVER SPECIFICATION 
5B-25 

INVALID KEEP SPECIFICATION 
5B-27 

INVALID KEYWORD 'keyword' 
5B-14 

INVALID LINK ‘linkid’ 5B—14 

INVALID LOCATION "locid'’ 
5B-16 

INVALID NJI BUFFER SIZE ... 
5B-60 

INVALID NJI NODAL RESISTANCE 
--.- 5SB-60 

INVALID NJI PARAMETER ‘parm’ 
~--.- 5B-60 

INVALID NJI SIGNON 
CONNECTION ... 5B-—61 

INVALID OPTION *keyword’ ... 
5B-15 

INVALID PASSWORD PARAMETER 


--- 5B-60 

INVALID POWER CPUID 
SPECIFIED ... 5B-66 

INVALID REPLY — ANSWER "YES" 
--- 5B=-28 

INVALID SML MODE SPECIFIED 
--- 5B—-58 

INVALID SPOOL BLOCK FORMAT 
--- 5B-13 


INVALID SPOOL ID ‘"spoolid’ 
5B-14 

INVALID TASK SPECIFICATION 
5B—26 

INVALID USER ID "userid’ 
5B—15 

INVALID ZONE SPECIFICATION 
5B—-26 

IPL DEVICE ERROR — REENTER 
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5B-28 

IPL DEVICE READ I/O ERROR 
5B-31 

IPL DEVICE WRITE I/O ERROR 
5B-31 

LINE '*vaddr’ CC=3 NOT 
OPERATIONAL ... 5B-53 
LINE *vaddr’® DISABLED FOR 
... 5B-12 

LINE *vadedr’ I$ IN USE BY 
LINK ... 5B-52 


LINE 'vaddr' READY FOR ... 
5B-9 

LINE OR CHANNEL I/O ERROR 
... 5B-63 

LINK *linkid’ 
(CONNECT|ACTIVE) ~- ‘type? 
LINE... 58-49 

LINK "linkid’ 
(CONNECT|ACTIVE) ‘task! 


"type'... 5B—-44 

LINK "linkid® ACTIVE -— NO 
oes 58-32 

LINK *linkid’® ACTIVE -— NOT 
DELETED 58-36 

LINK "linkid® ACTIVE -—— NOT 


REDEFINED 5B-35 
LINK "linkid' ALREADY ACTIVE 
--- 5SB-55 
LINK "*linkid" ALREADY IN ... 
5B-40 
LINK "linkid® ALREADY SET 
--- 5B—-38 
LINK "linkid’® DEACTIVATED 
5B-2 
LINK "linkid’® DEACTIVATION 


--. 5B—-66 

LINK "linkid’® DEFAULT ‘task’ 
--- 5B—44 

LINK "linkid’ DOES NOT MATCH 
--. 5SB-62 


LINK "*linkid® EXECUTING: ... 
5B—2 

LINK "linkid’® FILE 
TRANSMISSION ... S5SB-39 

LINK "linkid*® HAS A FILE ... 
5B~36 

LINK "*linkid’® IN POWER MODE 
~-- 5B—-65 

LINK *linkid® IN RJE MODE 
--- 5SB-64% 

LINK "linkid’ INACTIVE 
5B-43 

LINK "linkid’ INACTIVE —— 


DEFAULT... 58-49 
LINK "linkid® INVALID ‘*CMD* 
--- 5B-65 
LINK ‘linkid’® IS NOT ACTIVE 
5B-17 
LINK *linkid’ IS NOT DEFINED 


5B-17 
LINK *linkid’ LINE ‘vaddr’ 
DATASET... 5B-9 


LINK *linkid’ LINE ‘'vaddr’ 
DISCONNECTED S5B-9 

LINK *linkid’® LINE ACTIVITY: 
--- S5SB-11 

LINK "*linkid’ LOG ACTIVATED 
5B—-56 

LINK "linkid’ LOG ALREADY 
ACTIVE 58-57 

LINK *linkid’ LOG 
DEACTIVATED 5B-56 

LINK "linkid’' LOG NOT ACTIVE 
5B-57 

LINK "linkid’ NOT CONNECTED 
5B-18 

LINK "‘linkid’ NOT DEFINED 
--- 5B-36 

LINK "linkid’ NOT IN HOLD 
22. 5B-39 

LINK "linkid"® NOW DELETED 
5B-—36 

LINK "*linkid’ NOW SET TO ... 
5B-37 

LINK "linkid’ POWER COMMAND 
~-- 5B—-65 

LINK "*linkid’® QUEUE 
REORDERED 5B—34 

LINK "linkid’® REDEFINED 


5B-35 
LINK "*linkid' RESUMING FILE 
sax. SB=39 
LINK ‘'linkid’ S=s R=r Q=q 
P=p 58-45 
LINK "linkid’® STILL ACTIVE 
~--- 5SB-56 


LINK "linkid' SUM REPORTING 
ALREADY ACTIVE 5B-57 

LINK "*linkid’ SUM REPORTING 
DEACTIVATED 58-56 

LINK "linkid® SUM REPORTING 
NOT ACTIVE 58-57 

LINK "linkid' TO SUSPEND 
FILE TRANSMISSION 5B-39 
LINK ID MISSING OR INVALID 
5B-25 

LOCAL LOCATION DEFINITION 
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1-3 


--.- 5B-30 

LOCAL PREVIOUSLY SPECIFIED 
5B-23 

LOCATION "’locid’ EXECUTING: 
~-. 5B-3 

LOCATION ‘locid’ HAS A FILE 
~-- 5B—-43 

LOCATION "locid’ IS NOT ... 
5B-18 

LOCATION ‘locid’(’userid’) 
-.- 5B-3 

LOCATION ID MISSING OR ... 
5B-25 


MAX C'nn’) ACTIVE -— LINK 
--.- 5B-55 

MAX TAGS REQUEST OF 1 PER 
--- 5B-22 


NEW LINK 'linkid’ DEFINED 
5B-35 

NJI LINK "linkid’: 
<JOB|OUTPUT> ... 5B-61 

NO FILE ACTIVE 5B-48 

NO FILE ACTIVE ON LINK 
"linkid’, 5B-33 

NO FILES QUEUED 58-50 

NO LINK ACTIVE 5B-50 

NO LINK DEFINED 58-50 

NO LOCATIONS ROUTED 5B-42 

NO PORTS AVAILABLE 5B-40 

NO REMOTE PUNCH AVAILABLE ON 


o-- 5B-64 

NO SWITCHED LINE AVAILABLE 
eee 5B-52 

NON=SIGNON CARD READ ON LINK 
--- 5SB-58 

NONRECOVERABLE PROGRAM ERROR 
ee. 5B-63 

NUCLEUS CYL/BLK ADDRESS = 
ee. 5B—21 

NUCLEUS CYL/BLK 
SPECIFICATION ... 5B-28 

NUCLEUS WRITE COMPLETE 

5B-19 

PARM PREVIOUSLY SPECIFIED 
--- 5B-23 

PASSWORD SUPPLIED ON LINK 
*linkid’... 5B-58 


PORT *vaddr’* AVAILABLE 
5B-40 

PORT *vaddr’* IN USE BY LINK 
--- SB-41 

PORT ADDRESS MISSING OR ... 
5B-26 

POWER COMMAND FROM ‘linkid’ 


--- 5B—-66 

PRINTER ON LINK ... 5B-62 

PROGRAM CHECK —-— LINK °*... 
5B-4 

PROGRAM CHECK IN SUPERVISOR 
oe. 5SB—-4 

RECEIVED FILE (*orgid’) ON 
LINK... 5B-10 

RECEIVING FILE (*orgid’) ON 
LINK... 5B-10 


REJECTED BY TASK ‘task’ —- 
--- %5SB-16, 5B-17 

RESTRICTED COMMAND ‘*command’ 
5B-16 

REWRITE THE NUCLEUS ? 
<YES|NO> 58-20 

RSCS S5B-13 

RSCS VERSION vv, RELEASE 
--- 5B-1 

RSCS DIRECT mm/dd/yy hh:mn, 
--. 5B-19 

RSCS DISCONNECTING 5B-37 

SENDING FILE ‘’spoolid’ ... 
5B-10 

SENT FILE ‘*spoolid’ 
(forgid’) ... SB-11 

SIGNON OF LINK *linkid’ 
COMPLETE 5B-59 

SIGNON PARAMETER=‘parm’ ON 
LINK ... 5B-58 

SIGNON SEQUENCE ON LINK ... 
5B-62 

SIGNON TYPE PARAMETER 
MISSING 5B-59 

SYSTEM DISK ADDRESS = <cuu> 
5B-20 

SYSTEM ERROR READING SPOOL 
cae Be 7. 

TAGS COUNT MISSING OR 
INVALID 5B—-27 

TAGS PREVIOUSLY SPECIFIED 


5B-23 
TASK NAME ‘task*® ALREADY IN 
USE ... 5B—-55 


UNDEFINED LINK ID 5B—25 

UNSUPPORTED SYSTEM RESIDENCE 
--- 5B—-29 

USER "userid’ NOT IN CP ... 
5B-3 

USERID "userid’ NOT 
RECEIVING 5B-37 

USERID MISSING OR INVALID 
5B-18 

VIRTUAL STORAGE CAPACITY ... 


IBM VM/370: RSCS Networking — Ref and Operations 


Ld 


5B-54 
VIRTUAL STORAGE SIZE IN... 
5B=—-31 
user 4-24 
miscellaneous commands 3-7 
modifying an entry in the RSCS 
routing table 3-4, 5A-24 
modifying the supplied PROFILE 
RSCS 2-17 
modifying the supplied RSCS 
directory 2-17 
module source code 5G6-=3 
monitoring line activity 3-10 
MSG command 3-7, 5A-17 
MSUP (multi-tasking supervisor) 
1-10 
MULTI~LEAVING 
see also SML 
multi-node mesh connected network 
2-10 
multiple destination data sets 
3-11 


1-11, 5SE-25 


names of nodes 1-7 
network 
multi—-node mesh connected 2-10 
nedes 1-6 
sample 1-5 
three-node store and forward 
2-9 
two-node 2-9 
NJI line driver (DMTNJI) 3-11 
NJI line driver (DMTNJI) 1-21 
remote system operator 
functions 1-22 
RSCS operator functions 1-21 
software products supported 
1-21 
starting 3-30 
supported functions 1-21, 2-11 
VM/370 user functions 1-22 
node name 1-7 
nonprogrammable remote stations 
1-7 
nonprogrammable remote terminals 
5D-1 
notational conventions S5A-1 
NPT line driver (DMTNPT) 1-16 
hardware products supported 
1-16 
I/O control 1-18 
line allocation 1-18 
remote terminal operator 


functions 1-17 
RSCS operator functions 1-17 
starting 3-21 
supported functions 1-17, 2-10 
VM/370 user functions 1-18 
NPT messages 3-24 


operation 
characteristics, printer 3-26 
description 3-2 
differences from earlier 
programs 3-33 
procedures 3-14 
ORDER command 3-5, 5A-18 
output file processing 3-23 
overvien 1-2 


PARM (control statement) 2-6 
pending files 2-2, 2-7 
planning to install RSCS 2-2 
PORT (control statement) 2-7 
port specification 2-5 
POW line driver (DMTPOW) 1-14 
I/O control 1-15 
line allocation 1-16 
RSCS operator functions 1-15 
Signing on 3-20 
software products supported 
1-14 
starting 3-19, 5F-3 
supported functions 1-15, 2-10 
VM/370 user functions 1-15 
preloader 2-24 
printer operational 
Characteristics 3-26 
printer, 3270 3-27 
problem determination, verifying 
line service 5A-28 
processors and real storage 1-3 
PROFILE RSCS 3-14 
PROFILE SAMPLE EXEC 2-17 
programmable remote stations 1-7, 
5E-1 
programming systems for RSCS 1-2 
publications 
(see Preface) 
PURGE command 3-5, 5A-19 


QUERY command 3-9, 5A-19 
query status of a remote system 
5A-9 


Index I~9 


reconfiguration, dynamic 3-32 
record, accounting 1-8 
redirecting files 3-5, 5A-29 
remote 

addressing, two-level 2-11 

CP status, requesting 3-8 

nodes 1-3, 1-4 

stations 1-7 

systems 1-8 

terminal processor (RTP) 

programs 1-7 

terminal, operator commands 

3-24 
removing files from a queue 3-5, 
5A-19 
REQRDER command 3-5, 5A-24 
reordering files 3-5, 5A-24 


reordering the file queue for a 


link 5A-18 
repositioning files 3-6, 5A-4, 
5A-16 
requesting remote CP status 3-8 
requesting RSCS status 3-9 
requirements of RSCS 1-2 
restarting a line driver 3-31 
restrictions 
commands for DMTNJI 1-21 
commands for DMTVMB 1-20 
commands for DMTVMC 1-20 
resuming file transmission 3-3, 
5A-15 
REX task 1-10 


RJE mode of the SML line driver 
1-12 
RJE mode 3-17 
roles performed by RSCS 
ROUTE (control statement) 
ROUTE command 3-4, 5A-24 
routing table 1-7 
RSCS, 
defining/modifying/deleting an 
entry 5A-24 
RPT line driver (DMTRPT) 1-19 
features supported 1-19 
hardware products supported 
1-19 
Starting 3-24 
supported functions 2-11 
RSCS as a remote job entry station 
5E-52 
RSCS DIRECT 2-2 
RSCS messages 3-10 
RSCS operator commands 
communication 3-6 


1-4 
2-6 


3-2 
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CMD 3-6, 
MSG 3-7, 
file control 
BACKSPAC 
BACKSPACE 
CHANGE 


5A-8 

5BA-17 

3-4 

3-6 

5BA-G 

3-5, 5A-5 
CLOSE 3-6, S5A-7 
FLUSH 3-5, 5A-14% 
FWDSPACE 3-6, 5A-16 
ORDER 3-5, 5A—-18 
PURGE 3-5, 5A-19 
REORDER 3-5, 5A-24 
TRANSFER 3-5, 5A-29 

link and line control 
DEFINE 3-3, 5A-19 
DELETE 3-3, 5A-12 
DRAIN 3-3, 5A-13 
FORCE 3-3, 5A-15 
FREE 3-3, 5A-15 
HOLD 3-3, 5A-16 
ROUTE 3-4, 5A-24% 
SHUTDOWN 3-4, 5A-25 
START 3-4, 5A—-25 

miscellaneous’ 3-5, 
* (comment) 3-7, 
CP 3-7, 5A-9 
CPQUERY 3-8, 5A-9 
DISCONN 3-8, 5A-12 
EXEC 3-8, 5A-13 
HT 3-8, 5A-17 
QUERY 3-9, 5A-19 
TRACE 3-10, 5A-28 


3-2 


3-7 
5A-4 


RSCS 


components of 1-10 
directory 
directory control statements 
2-3 
directory, 
generating 2-14 
installing 2-12 
job submission 
to an MVS JES2/NJE batch 
processor 4-17 
line drivers 1-11 
mini-disk, linking to 
nucleus 2-14 
output transmission 
to an IBM 3270 printer 
preloader 2-24 
profile 2-17 
system disk 
building 2-20 
tape, attaching 
updating 2-24 


modifying the 2-17 


2-15 


4-21 


2-15 


and Operations 


virtual machine, defining 2-13 
RSCSBASE EXEC 2-20, 2-21 


Sample network 1-5 
sending 
commands 3-6 
to a remote system 5A-8 
messages 3-7 
to a remote staation 
service tape contents 2-12 
SHUTDOWN command 3-4, 3-14, 5A-25 
Signing on to NPT 3-21 
Signon procedure for the remote 
VSE/POWER system 5F-4 
SML line driver (DMTSML) 1-1] 
file processing in RJE mode 
3-17 
hardware products supported 
1-12 
I/O control 1-13 
input file processing in HOST 
mode 3-18 
line allocation 1-14 
messages 3-19 
output file processing in HOST 
mode 3-18 
remote station operator 
commands 3-19 
remote station operator 
functions 1-13 
RSCS operator functions 1-12 
signing on 3-17 
software products supported 
1-11 
starting 3-15 
supported functions 
task 1-12 
VM/370 user functions 1-13 
SML messages 3-19 
SMSG command, VM/370 4-10 
SMSG use examples 4-22 
Specifying Destination of VM/370 
Virtual Output 4-12 
spontaneous messages 5B-67 
SPOOL command, VM/370 4-2 
spool file tags 1-6 
spool file, changing attributes 
5A-5 
Spool MULTI-LEAVING 
5E-25 
see also SML 
spooling interface 1-23 
staging disks 2-19 


5A-17 


l-11, 5E-1, 


START command 
starting 
line drivers 3-14 


3-4, 5A-25 


NJI 3-30 
NPT 3-21 
POW 3-19, 5F—-3 
RPT 3-24 
SML 3-15 
VMB 3-28 
VMC 3-29 


stations, remote 1-7 

status information, displaying 
5A-19 

storage requirements for RSCS 1-3 

store-and-forward facilities 1-8 

supervisor 1-10 

suppress printing of messages 
3-8, 5A-17 

suspending file transmission 3-3 

suspending files for a particular 
link 5A—-16 

system information obtained by 
QUERY command 3-9 


system 
control tasks 1-6 
disk 2-2 


remote 1-8 
shut—down 3-14 
start-up 3-14 


table 

link 1-7, 3-32 

routing 1-7, 3-32 
TAG command, VM/370 4-% 
tag slots 

generation of 2-2 

maximum that can be generated 

2-7 

reserved for the link 2-6 
TAGS (control statement) 2-7 
task names reserved for RSCS 2-5 
terminating 

an operation 3-4 

RSCS operations 5A=-25 

VSE/POWER connection 5F-—5 
three-node store and forward 

network 2-9 

time zone boundaries 2-4, 2-5 
tools for servicing RSCS 56-2 
TRACE command 3-10, 5A-28 
TRANSFER command 3-5, 5A-29 
transmission priority 1-6 
transmitting commands to the 


Index I-11 


VM/370 control program S5A-9 
two-level remote addressing 2-11 
two-node network 2-9 
types of line drivers 1-8 


updating RSCS 2-24 
user commands 4-2 
user examples 4-12 
user exits 5C-1 
user messages 4-24 


verifying line service 5A-28 
Vertical Forms Control 3-27 
(see also VFC) 
VFC 3-26, 3-27 
virtual output 
specifying destination 4-12 
virtual storage for RSCS 1-3 
VMB line driver (DMTVMB) 1-20 
remote system operator 
functions 1-22 
RSCS operator functions 1-21 
software products supported 
1-21 
starting 3-28 
supported functions 1-21, 2-11 
VM/370 user functions 1-22 
VMC line driver (DMTVMC) 1-20 
remote system operator 
functions 1-22 
RSCS operator functions 1-21 
software products supported 
1-21 
starting 3-29 
supported functions 1-21, 2-11 


VM/370 user functions 1-22 
VSE/POWER 1-14, 3-19 
configuration specifications 


5SF-1 
establishing a communication 
line 5F—-3 


generating for the RSCS 
connection 5F-1 
input functions 5F-2 
operating procedures 5F—2 
output functions 5F-2 
remote system connection 5F-1 
return of job output to RSCS 
5F—-4 
Signon procedure 5F=-4 
starting the POW line driver 
5F—3 


termination of connection  5F-—5 


wait state codes, RSCS 5B-77 
workload leveling 1-8 


2520 S5E-17 

2560 S5E-18 

270x BSC protocol 1-14, 1-15, 
1-18 

2922 5E-12 


3270 printer 1-19, 3-27, 4-21 
3780 5D-15, 5D-16 


5424 5E-32 
5475 5€-35 
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